MoveClusterGroup

The MoveClusterGroup function moves a group and all of its resources from one node to another.

DWORD WINAPI MoveClusterGroup(
  HGROUP hGroup,           
  HNODE hDestinationNode   
);
 

Parameters

hGroup

[in] Handle to the group to be moved.

hDestinationNode

[in] Optional handle to the node where the moved group should be brought back online or NULL.

Return Values

ERROR_SUCCESS

The reassignment of ownership of the group has completed.

ERROR_IO_PENDING

The reassignment of ownership of the group is in progress.

If the operation was unsuccessful, MoveClusterGroup returns a Win32 error value.

Remarks

The return value from MoveClusterGroup indicates whether or not the group has successfully changed ownership. It does not imply anything about the state of the group and all of its resources. That is, if the group was in the online state prior to the move, it may or may not be online on its new node when MoveClusterGroup returns, regardless of the return value.

After the ownership of the group has been successfully reassigned, MoveClusterGroup returns and the Cluster Service attempts to restore the group and its resources to its previous state on the new node. For example, if before the move the group was partially online with an offline Generic Service resource and an online Physical Disk resource, after the move the Cluster Service attempts to bring the Physical Disk resource online on the new node. The Generic Service resource remains offline.

Since the ERROR_SUCCESS return value indicates only that the ownership of the group has changed, callers of MoveClusterGroup must assume that ERROR_SUCCESS implies ERROR_IO_PENDING and wait for completion. The caller may wait by either:

• Polling the state of each resource in the group.
• Creating a notification port and waiting for the appropriate CLUSTER_CHANGE_RESOURCE_STATE events to arrive.

When all of the resources in the group have been brought online, the caller can assume that the move operation has completed and that the resources have been restored to their original state.

When hDestinationNode is set to NULL, MoveClusterGroup attempts to move the group to the best possible node. If there is no node available that can accept the group, the function fails. MoveClusterGroup also fails if MoveClusterGroup determines that the group cannot be brought online on the node identified by the hDestinationNode parameter.

QuickInfo

  Version: Use Windows NT Server Enterprise Edition 4.0.
  Windows CE: Unsupported.
  Header: Declared in clusapi.h.