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 |
| 程式庫 | ClusAPI.lib |
| Dll | ClusAPI.dll |