changeClusterResourceGroup 函数 (clusapi.h)

资源 从一个 移到另一个组。 PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP类型定义指向此函数的指针。

语法

DWORD ChangeClusterResourceGroup(
  [in] HRESOURCE hResource,
  [in] HGROUP    hGroup
);

参数

[in] hResource

要移动的资源的句柄。

[in] hGroup

应接收 由 hResource 标识的资源的组句柄。

返回值

如果函数成功,则返回 ERROR_SUCCESS

如果函数失败,它将返回 系统错误代码之一。

注解

使用 ChangeClusterResourceGroup 函数时,无论资源的状态如何,资源当前所属的组及其新组都必须由同一 节点 拥有。

不要从资源 DLL 调用 ChangeClusterResourceGroup 。 有关详细信息,请参阅 在资源 DLL 中对避免的函数调用。 如果 hResource 标识的资源具有 依赖项,则其依赖项树中的所有资源都会移动到 由 hGroup 标识的组。 例如,在下图所示的情况下,将资源 B 更改为组 2 会将整个依赖项树 (资源 A、X 和 Y) 。

显示将资源移动到另一个组之前和之后群集资源组中资源之间的依赖关系树的关系图。

不要将 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

OpenClusterResource