GetClusterNetInterface 関数 (clusapi.h)
クラスター内のネットワークへのノードのインターフェイスの名前を返します。 PCLUSAPI_GET_CLUSTER_NET_INTERFACE型は、この関数へのポインターを定義します。
構文
DWORD GetClusterNetInterface(
[in] HCLUSTER hCluster,
[in] LPCWSTR lpszNodeName,
[in] LPCWSTR lpszNetworkName,
[out] LPWSTR lpszInterfaceName,
[in, out] LPDWORD lpcchInterfaceName
);
パラメーター
[in] hCluster
クラスターへの処理。
[in] lpszNodeName
クラスター内のノードの名前を含む null で終わる Unicode 文字列へのポインター。
[in] lpszNetworkName
ネットワークの名前を含む null で終わる Unicode 文字列へのポインター。
[out] lpszInterfaceName
ネットワーク インターフェイスの名前を保持する出力バッファーへのポインター。
[in, out] lpcchInterfaceName
lpszInterfaceName バッファーのサイズを文字数として指すポインター。 入力時に、バッファーが保持できる最大文字数 (終端の NULL を含む) を指定 します。 出力時に、終了する NULL を除く、結果の名前の文字数を指定 します。
戻り値
操作が成功した場合、関数は ERROR_SUCCESSを返します。
操作が失敗した場合、関数は システム エラー コードを返します。 使用可能な値の 1 つを次に示します。
リターン コード | 説明 |
---|---|
|
lpszInterfaceName が指すバッファーは、結果を保持するのに十分な大きさではありません。 lpcchInterfaceName パラメーターは、終了する NULL を除き、結果の文字数を返します。 |
注釈
lpcchInterfaceName はバイト数ではなく文字数を参照し、返されるサイズにはカウントに終端の NULL が含まれていないことに注意してください。 バッファーのサイズ設定の詳細については、「 データ サイズ規則」を参照してください。
要件
要件 | 値 |
---|---|
サポートされている最小のクライアント | サポートなし |
サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
対象プラットフォーム | Windows |
ヘッダー | clusapi.h |
Library | ClusAPI.lib |
[DLL] | ClusAPI.dll |