GetClusterNodeId 関数 (clusapi.h)
クラスター ノードの一意識別子を返 します。 PCLUSAPI_GET_CLUSTER_NODE_ID型は、この関数へのポインターを定義します。
構文
DWORD GetClusterNodeId(
[in, optional] HNODE hNode,
[out] LPWSTR lpszNodeId,
[in, out] LPDWORD lpcchName
);
パラメーター
[in, optional] hNode
返される識別子または NULL を持つノードへのハンドル。 hNode が NULL に設定されている場合、アプリケーションが実行されているノードのノード識別子が lpszNodeId の内容で返されます。
[out] lpszNodeId
このパラメーターは、終端の NULL 文字を含む hNode の一意の ID を受け取るバッファーを指します。
[in, out] lpcchName
入力時に、 lpszNodeId パラメーターが指すバッファー内の文字数 ( NULL 終端記号を含む) へのポインター。 出力時に、 NULL 終端記号を除くバッファーに格納されている文字数へのポインター。
戻り値
この関数は 、システム エラー コードを返します。 使用できる値を次に示します。
| リターン コード/値 | Description |
|---|---|
|
操作は正常に完了しました。 |
|
詳細なデータを入手できます。 lpszNodeId が指すバッファーが、必要な文字数を保持するのに十分な長さでない場合、この値が返されます。 GetClusterNodeId は、lpcchName の内容を必要な長さに設定します。 |
注釈
PCLUSAPI_GET_CLUSTER_NODE_ID型は、この関数へのポインターを定義します。
hNode が NULL に設定されていて、呼び出し元がアクティブなクラスター ノードで実行されている場合、GetClusterNodeId 関数は、アプリケーションが実行されているノードの識別子を返します。 hNode を NULL に設定すると、リソース DLL が実行されているノードのノード識別子を判断するのに便利な方法です。 hNode パラメーターに NULL を渡す代わりに、GetCurrentClusterNodeId マクロを使用できます。
クラスター ノード識別子は、ノードの名前が変更されても変更されない一意の識別子です。
lpcchName はバイト数ではなく文字数を参照し、返されるサイズにはカウントに終端の NULL が含まれていないことに注意してください。 バッファーのサイズ設定の詳細については、「 データ サイズ規則」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |