3.1.4.3.4.22 CLUSCTL_NODE_SCALEOUTNODE_PLACEMENT_UPDATE

The CLUSCTL_NODE_SCALEOUTNODE_PLACEMENT_UPDATE node control code<204> returns the migration result of the virtual machine from one cluster to another cluster.

The client MUST provide a PROPERTY_LIST structure, as specified in section 2.2.3.10, in the buffer that is designated by the lpInBuffer parameter. The PROPERTY_LIST MUST contain a property with names "CLUSREG_NAME_RES_VM_ID” whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_SZ, “SCALEOUT_PLACEMENT_VERSION” whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_DWORD, and “SCALEOUT_PLACEMENT_RESULT_VM_MIGRATION_RESULT” whose syntax is CLUSPROP_SYNTAX_LIST_VALUE_DWORD. See section 2.2.2.3 for more details.

If CLUSREG_NAME_RES_VM_ID is not provided in the IpInBuffer, the server MUST fail the request with ERROR_INVALID_DATA.

If SCALEOUT_PLACEMENT_RESULT_VM_MIGRATION_RESULT is not provided in the IpInBuffer, the server MUST fail the request with ERROR_INVALID_DATA.

After successful completion of this method, the server MUST update scaleout node placement, using the properties provided by the client, to cluster service in an implementation-specific manner.

The server MUST accept a CLUSCTL_NODE_SCALEOUTNODE_PLACEMENT_STATE node control code request if its protocol server state is in the read/write state, as specified in section 3.1.1.