ホーム › Networking.Clustering › PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX

PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX

コールバック

シグネチャ

HNETINTERFACE PCLUSAPI_OPEN_CLUSTER_NETINTERFACE_EX(
    HCLUSTER hCluster,
    LPWSTR lpszNetInterfaceName,
    DWORD dwDesiredAccess,
    DWORD* lpdwGrantedAccess
);

パラメーター

フィールド	型	説明
hCluster	HCLUSTER	クラスターのハンドルです。
lpszNetInterfaceName	LPWSTR
dwDesiredAccess	DWORD	要求するアクセス権限です。GENERIC_READ (0x80000000)、GENERIC_ALL (0x10000000)、MAXIMUM_ALLOWED (0x02000000) の任意の組み合わせを指定できます。この値が 0 の場合は、未定義のエラーが返されることがあります。GENERIC_ALL を使用することは、OpenClusterNetInterface を呼び出すことと同じです。
lpdwGrantedAccess	DWORD*	省略可能なパラメーターで、許可されたアクセス権を受け取る DWORD のアドレスを指定します。DesiredAccess パラメーターが MAXIMUM_ALLOWED (0x02000000) の場合、このパラメーターが指す DWORD には、このユーザーに許可される最大の権限が格納されます。

公式ドキュメント

ネットワークインターフェイスへのハンドルを開きます。

戻り値

操作が成功した場合、OpenClusterNetInterfaceEx は指定されたネットワークインターフェイスへの開かれたハンドルを返します。

戻り値	説明
NULL	操作は成功しませんでした。エラーの詳細については、GetLastError 関数を呼び出してください。対象のサーバーが OpenClusterNetInterfaceEx 関数をサポートしていない場合 (たとえば対象のサーバーが Windows Server 2008 以前を実行している場合)、GetLastError 関数は RPC_S_PROCNUM_OUT_OF_RANGE (1745) を返します。

出典・ライセンス: 上記「公式ドキュメント」の内容は Microsoft の Win32 API ドキュメント(MicrosoftDocs/sdk-api)を日本語に翻訳・改変したものです。© Microsoft Corporation. CC BY 4.0 で提供。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)