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 |