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

PCLUSAPI_SET_CLUSTER_NETWORK_PRIORITY_ORDER

コールバック

シグネチャ

DWORD PCLUSAPI_SET_CLUSTER_NETWORK_PRIORITY_ORDER(
    HCLUSTER hCluster,
    DWORD NetworkCount,
    HNETWORK* NetworkList
);

パラメーター

フィールド型説明
hClusterHCLUSTER対象となる クラスター のハンドルです。
NetworkCountDWORDNetworkList パラメーターで指定されたリスト内の項目数です。
NetworkListHNETWORK*ネットワークオブジェクトのハンドルを優先順位順に並べた配列です。配列の先頭のハンドルが最も優先順位が高くなります。 このリストには、クラスター内のノード間の内部通信に使用されるネットワークだけを含める必要があり、 重複があってはなりません。

公式ドキュメント

[この関数は、要件セクションに示されたオペレーティングシステムで使用できます。このメソッドのサポートは Windows Server 2008 で削除されており、この関数は何も行わず ERROR_CALL_NOT_IMPLEMENTED を返します。]

クラスターの ノード 間の内部通信に使用される ネットワーク のセットに対して優先順位を設定します。PCLUSAPI_SET_CLUSTER_NETWORK_PRIORITY_ORDER 型は、この関数へのポインターを定義します。

戻り値

操作が成功した場合、この関数は ERROR_SUCCESS (0) を返します。

操作が失敗した場合、この関数は システムエラーコード を返します。次のエラーコードが返される可能性があります。

戻り値/値 説明
ERROR_INVALID_PARAMETER
87 (0x57)
 NetworkList 内に重複したネットワークがありました。

解説(Remarks)

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

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