共用方式為

moveClusterGroup 函式 (clusapi.h)

  • 發行項

將 群組 及其所有 資源 從一個節點移至另一個 節點 。 PCLUSAPI_MOVE_CLUSTER_GROUP類型會定義此函式的指標。

語法

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

參數

[in] hGroup

要移動之群組的句柄。

[in, optional] hDestinationNode

應將移動群組帶回在線或 NULL 的節點句柄。

傳回值

如果作業成功，函式會 傳回ERROR_SUCCESS。

如果作業失敗，函式會傳回 系統錯誤碼。 以下是其中一個可能的錯誤碼。

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

另請參閱

OpenCluster

OpenClusterGroup

OpenClusterNode