OpenClusterNodeEx 関数 (clusapi.h)
ノードを開き、ハンドルを返します。
構文
HNODE OpenClusterNodeEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszNodeName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
パラメーター
[in] hCluster
OpenCluster または OpenClusterEx 関数から返されたクラスターへのハンドル。
[in, optional] lpszNodeName
既存のノードの NetBIOS 名へのポインター。 ノードの DNS 名を使用すると、 OpenClusterNodeEx 関数は失敗し、 GetLastError は ERROR_CLUSTER_NODE_NOT_FOUNDを返します。
[in] dwDesiredAccess
要求されたアクセス特権。 これは、 GENERIC_READ (0x80000000 )、GENERIC_ALL ( 0x10000000 )、または MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせです。 この値がゼロ (0) の場合、未定義のエラーが返される可能性があります。 GENERIC_ALLの使用は、OpenClusterNode の呼び出しと同じです。
[out, optional] lpdwGrantedAccess
付与されたアクセス権を受け取る DWORD のアドレスを含む省略可能なパラメーター。 DesiredAccess パラメーターがMAXIMUM_ALLOWED (0x02000000) の場合、このパラメーターが指す DWORD には、このユーザーに付与される最大特権が含まれます。
戻り値
操作が成功した場合、 OpenClusterNodeEx は ノード ハンドルを返します。
リターン コード | 説明 |
---|---|
|
操作が成功しなかった。 エラーの詳細については、 GetLastError 関数を呼び出します。 ターゲット サーバーが OpenClusterNodeEx 関数をサポートしていない場合 (たとえば、ターゲット サーバーが Windows Server 2008 以前を実行している場合)、 GetLastError 関数は RPC_S_PROCNUM_OUT_OF_RANGE (1745) を返します。 |
要件
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2008 R2 Datacenter、Windows Server 2008 R2 Enterprise |
対象プラットフォーム | Windows |
ヘッダー | clusapi.h |
Library | ClusAPI.lib |
[DLL] | ClusAPI.dll |