MoveClusterGroup 関数 (clusapi.h)
グループとそのすべてのリソースを 1 つのノードから別のノードに移動します。 PCLUSAPI_MOVE_CLUSTER_GROUP型は、この関数へのポインターを定義します。
構文
DWORD MoveClusterGroup(
[in] HGROUP hGroup,
[in, optional] HNODE hDestinationNode
);
パラメーター
[in] hGroup
移動するグループへのハンドル。
[in, optional] hDestinationNode
移動したグループをオンラインまたは NULL に戻す必要があるノードへのハンドル。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 考えられるエラー コードの 1 つを次に示します。
| リターン コード | 説明 |
|---|---|
|
グループの所有権の再割り当てが進行中です。 |
注釈
MoveClusterGroup 関数からの戻り値は、グループまたはそのリソースの状態に関する何も意味しません。 戻り値は、所有権の変更が成功したかどうかを示すだけです。 MoveClusterGroup から戻った後、クラスターは常に移動前の状態にグループを返そうとします。
移動後にアプリケーションでリソースまたはグループの特定の状態を確保する場合:
- 移動前の状態を確認します。 クラスターは、移動後にその状態の復元を試みます。
- 移動後の状態をポーリングし、必要に応じて調整します。 または、通知ポートを作成し (「 クラスター イベントの受信」を参照) し、 CLUSTER_CHANGE_GROUP_STATE イベントを待機します。
リソース 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 |