OpenClusterNetworkEx 関数 (clusapi.h)

ネットワークへの接続を開き、 それに 対するハンドルを返します。

構文

HNETWORK OpenClusterNetworkEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszNetworkName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

パラメーター

[in] hCluster

クラスターへのハンドル。

[in, optional] lpszNetworkName

既存のネットワークの名前へのポインター。

[in] dwDesiredAccess

要求されたアクセス特権。 これは、 GENERIC_READ (0x80000000 )、GENERIC_ALL ( 0x10000000 )、または MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせです。 この値が 0 (0) で、未定義のエラーが返される可能性があります。 GENERIC_ALLの使用は、OpenClusterNetwork の呼び出しと同じです。

[out, optional] lpdwGrantedAccess

付与されたアクセス権を受け取る DWORD のアドレスを含む省略可能なパラメーター。 DesiredAccess パラメーターがMAXIMUM_ALLOWED (0x02000000) の場合、このパラメーターが指す DWORD には、このユーザーに付与される最大特権が含まれます。

戻り値

操作が成功した場合、 OpenClusterNetworkEx は ネットワーク ハンドルを返します。

リターン コード	説明
NULL	操作が成功しなかった。 エラーの詳細については、 GetLastError 関数を呼び出します。 ターゲット サーバーが OpenClusterNetworkEx 関数をサポートしていない場合 (たとえば、ターゲット サーバーが 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

関連項目

CloseClusterNetwork

フェールオーバー クラスターネットワーク管理機能

OpenClusterNetwork