通过

moveClusterGroup 函数 (clusapi.h)

  • 项目

将 组 及其所有 资源 从一个节点移到另一个 节点 。 PCLUSAPI_MOVE_CLUSTER_GROUP类型定义指向此函数的指针。

语法

DWORD MoveClusterGroup(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode
);

参数

[in] hGroup

要移动的组的句柄。

[in, optional] hDestinationNode

应使移动组重新联机的节点的句柄或 为 NULL。

返回值

如果操作成功，函数将返回 ERROR_SUCCESS。

如果操作失败，该函数将返回 系统错误代码。 下面是可能的错误代码之一。

返回代码 说明
ERROR_IO_PENDING
 正在重新分配组的所有权。

注解

MoveClusterGroup 函数的返回值并不表示有关组或其任何资源的状态。 返回值仅指示所有权更改是否成功。 从 MoveClusterGroup 返回后，群集始终尝试将组返回到移动前的状态。

如果希望应用程序在移动后确保资源或组的特定状态：

  1. 检查移动前的状态。 群集将在移动后尝试还原该状态。
  2. 移动后轮询状态，并根据需要进行调整。 或者创建通知端口 (请参阅 接收群集事件) 并等待 CLUSTER_CHANGE_GROUP_STATE 事件。
当 hDestinationNode 设置为 NULL 时， MoveClusterGroup 会尝试将组移动到最佳节点。 如果没有可接受组的可用节点，则函数将失败。 如果 MoveClusterGroup 确定组无法在由 hDestinationNode 参数标识的节点上联机，MoveClusterGroup 也会失败。

不要从资源 DLL 调用 MoveClusterGroup 。 有关详细信息，请参阅 在资源 DLL 中对避免的函数调用。

不要将 LPC 和 RPC 句柄传递给同一函数调用。 否则，调用将引发 RPC 异常，并可能产生额外的破坏性影响。 有关如何创建 LPC 和 RPC 句柄的信息，请参阅 使用对象句柄 和 OpenCluster。

要求

要求 值
最低受支持的客户端 无受支持的版本
最低受支持的服务器 Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
目标平台 Windows
标头 clusapi.h
Library ClusAPI.lib
DLL ClusAPI.dll

另请参阅

OpenCluster

OpenClusterGroup

OpenClusterNode