OpenClusterResourceEx 関数 (clusapi.h)
リソースを開き、それにハンドルを返します。
構文
HRESOURCE OpenClusterResourceEx(
[in] HCLUSTER hCluster,
[in, optional] LPCWSTR lpszResourceName,
[in] DWORD dwDesiredAccess,
[out, optional] DWORD *lpdwGrantedAccess
);
パラメーター
[in] hCluster
クラスターへの処理。
[in, optional] lpszResourceName
開くリソースの名前を含む null で終わる Unicode 文字列へのポインター。
リソース名では大文字と小文字は区別されません。 リソース名は、クラスター内で一意である必要があります。 名前はリソースの作成時に設定され、 SetClusterResourceName 関数を使用して変更できます。
[in] dwDesiredAccess
要求されたアクセス特権。 これは、 GENERIC_READ (0x80000000 )、GENERIC_ALL ( 0x10000000 )、または MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせです。 この値がゼロ (0) の場合、未定義のエラーが返される可能性があります。 GENERIC_ALLの使用は、OpenClusterResource の呼び出しと同じです。
[out, optional] lpdwGrantedAccess
付与されたアクセス権を受け取る DWORD のアドレスを含む省略可能なパラメーター。 DesiredAccess パラメーターがMAXIMUM_ALLOWED (0x02000000) の場合、このパラメーターが指す DWORD には、このユーザーに付与される最大特権が含まれます。
戻り値
操作が成功した場合、 OpenClusterResourceEx は 、開いているリソースへのハンドルを返します。
リターン コード | 説明 |
---|---|
|
操作が成功しなかった。 エラーの詳細については、 GetLastError 関数を呼び出します。 ターゲット サーバーが OpenClusterResourceEx 関数をサポートしていない場合 (たとえば、ターゲット サーバーが 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 |