Win32 API 日本語リファレンス
ホーム › Networking.Clustering › PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP

PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP

コールバック

シグネチャ

DWORD PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP(
    HRESOURCE hResource,
    HGROUP hGroup
);

パラメーター

フィールド型説明
hResourceHRESOURCE移動するリソースのハンドルです。
hGroupHGROUPhResource で識別されるリソースを受け取るグループのハンドルです。

公式ドキュメント

リソースを、ある グループから別のグループへ移動します。 PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP 型は、この関数へのポインターを定義します。

戻り値

関数が成功した場合は、ERROR_SUCCESS を返します。

関数が失敗した場合は、システム エラー コード のいずれかを返します。

解説(Remarks)

ChangeClusterResourceGroup 関数では、リソースが現在属しているグループと移動先の新しいグループの両方が、リソースの状態にかかわらず同じ ノード によって所有されている必要があります。

ChangeClusterResourceGroup をリソース DLL から呼び出さないでください。詳細については、 リソース DLL で呼び出しを避けるべき関数 を参照してください。 hResource で識別されるリソースに 依存関係 がある場合、その依存関係ツリー内のすべてのリソースが hGroup で識別されるグループに移動されます。たとえば、次の図に示す状況では、リソース B をグループ 2 に変更すると、依存関係ツリー全体 (リソース A、X、Y) が移動します。

:::image type="content" source="./images/resmove.png" border="false" alt-text="リソースが別のグループに移動される前と後における、クラスター リソース グループ内のリソース間の依存関係ツリーを示す図。":::

LPC ハンドルと RPC ハンドルを同じ関数呼び出しに渡さないでください。渡した場合、呼び出しは RPC 例外を発生させ、さらに破壊的な影響を及ぼすおそれがあります。LPC ハンドルと RPC ハンドルの作成方法については、 オブジェクト ハンドルの使用 および OpenCluster を参照してください。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)