ホーム › Networking.Clustering › PCLUSAPI_CLUSTER_NODE_CONTROL

PCLUSAPI_CLUSTER_NODE_CONTROL

コールバック

シグネチャ

DWORD PCLUSAPI_CLUSTER_NODE_CONTROL(
    HNODE hNode,
    HNODE hHostNode,
    DWORD dwControlCode,
    void* lpInBuffer,
    DWORD nInBufferSize,
    void* lpOutBuffer,
    DWORD nOutBufferSize,
    DWORD* lpBytesReturned
);

パラメーター

フィールド	型	説明
hNode	HNODE	影響を受けるノードのハンドルです。
hHostNode	HNODE	NULL 以外の場合は、hNode で指定したノードの代わりに操作を実行するノードのハンドルです。NULL の場合は、この呼び出しを処理するノードが操作を実行します。
dwControlCode	DWORD	実行する操作を指定するノード制御コードです。制御コードに対応する構文については、制御コードのアーキテクチャと次のトピックを参照してください。 CLUSCTL_NODE_ENUM_COMMON_PROPERTIES CLUSCTL_NODE_ENUM_PRIVATE_PROPERTIES CLUSCTL_NODE_GET_CHARACTERISTICS CLUSCTL_NODE_GET_COMMON_PROPERTIES CLUSCTL_NODE_GET_COMMON_PROPERTY_FMTS CLUSCTL_NODE_GET_FLAGS CLUSCTL_NODE_GET_ID CLUSCTL_NODE_GET_NAME CLUSCTL_NODE_GET_PRIVATE_PROPERTIES CLUSCTL_NODE_GET_PRIVATE_PROPERTY_FMTS CLUSCTL_NODE_GET_RO_COMMON_PROPERTIES CLUSCTL_NODE_GET_RO_PRIVATE_PROPERTIES CLUSCTL_NODE_SET_COMMON_PROPERTIES CLUSCTL_NODE_SET_PRIVATE_PROPERTIES CLUSCTL_NODE_UNKNOWN CLUSCTL_NODE_VALIDATE_COMMON_PROPERTIES CLUSCTL_NODE_VALIDATE_PRIVATE_PROPERTIES
lpInBuffer	void*	操作に必要な情報が格納された入力バッファーへのポインターです。情報が不要な場合は NULL を指定します。
nInBufferSize	DWORD	入力バッファーに割り当てられたサイズ (バイト単位) です。
lpOutBuffer	void*	操作の結果として得られるデータを受け取る出力バッファーへのポインターです。データが返されない場合は NULL を指定します。
nOutBufferSize	DWORD	出力バッファーに割り当てられたサイズ (バイト単位) です。
lpBytesReturned	DWORD*	操作の結果として得られたデータの実際のサイズ (バイト単位) を返します。この情報が不要な場合は、 lpBytesReturned に NULL を渡します。

公式ドキュメント

ノードに影響する操作を開始します。実行される操作は、 dwControlCode パラメーターに渡される制御コードによって決まります。

戻り値

この関数は次のいずれかの値を返します。

リターンコード	説明
ERROR_SUCCESS	操作は成功しました。操作に出力バッファーが必要だった場合、 lpBytesReturned (入力時に NULL でない場合) は、バッファーに返されたデータの実際のサイズを指します。
ERROR_MORE_DATA	lpOutBuffer が指す出力バッファーが、操作の結果として得られたデータを保持するには小さすぎました。lpBytesReturned パラメーター (入力時に NULL でない場合) は、出力バッファーに必要なサイズを指します。ERROR_MORE_DATA を返すのは、出力バッファーを必要とする操作だけです。 lpOutBuffer パラメーターが NULL で、 nOutBufferSize パラメーターが 0 の場合は、ERROR_MORE_DATA ではなく ERROR_SUCCESS が返されることがあります。
システムエラーコード	操作は失敗しました。操作に出力バッファーが必要だった場合、 lpBytesReturned (入力時に NULL でない場合) で指定される値は信頼できません。

解説(Remarks)

ClusterNodeControl が ERROR_MORE_DATA を返した場合は、nOutBufferSize に lpBytesReturned が指すバイト数を設定して、関数をもう一度呼び出してください。

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

ClusterNodeControl は制御コード関数の 1 つです。制御コードおよび制御コード関数の詳細については、制御コードの使用を参照してください。

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