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 つを次に示します。

リターン コード 説明
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
Library ClusAPI.lib
[DLL] ClusAPI.dll

こちらもご覧ください

OpenCluster

OpenClusterGroup

OpenClusterNode

  • Last updated on