次の方法で共有


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 関数は失敗し、 GetLastErrorERROR_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 は ノード ハンドルを返します。

リターン コード 説明
NULL
操作が成功しなかった。 エラーの詳細については、 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

関連項目

CloseClusterNode

ノード管理機能

OpenCluster

OpenClusterEx

OpenClusterNode