GetClusterNetworkId 関数 (clusapi.h)

ネットワークの識別子を返します。 PCLUSAPI_GET_CLUSTER_NETWORK_ID型は、この関数へのポインターを定義します。

構文

DWORD GetClusterNetworkId(
  [in]      HNETWORK hNetwork,
  [out]     LPWSTR   lpszNetworkId,
  [in, out] LPDWORD  lpcchName
);

パラメーター

[in] hNetwork

ネットワークへのハンドル。

[out] lpszNetworkId

null 終端文字を含む、 hNetwork に関連付けられているネットワークの識別子へのポインター。

[in, out] lpcchName

文字数としての lpszNetworkID バッファーのサイズへのポインター。 入力時に、バッファーが保持できる最大文字数 (終端の NULL を含む) を指定 します。 出力時に、終了する NULL を除く、結果の名前の文字数を指定します。

戻り値

操作が成功した場合、関数は ERROR_SUCCESSを返します。

操作が失敗した場合、関数は システム エラー コードを返します。 使用可能な値の 1 つを次に示します。

リターン コード 説明
ERROR_MORE_DATA
lpszNetworkID が指すバッファーは、結果を保持するのに十分な大きさではありません。 lpcchNetworkID パラメーターは、終了する NULL を除き、結果の文字数を返します。

注釈

lpcchNetworkID はバイト数ではなく文字数を参照し、返されるサイズにはカウントに終端の NULL が含まれないことに注意してください。 バッファーのサイズ設定の詳細については、「 データ サイズ規則」を参照してください。

要件

要件 値
サポートされている最小のクライアント サポートなし
サポートされている最小のサーバー Windows Server 2008 Enterprise、Windows Server 2008 Datacenter
対象プラットフォーム Windows
ヘッダー clusapi.h
Library ClusAPI.lib
[DLL] ClusAPI.dll

こちらもご覧ください

OpenClusterNetwork