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。
如果作業失敗,函式會傳回 系統錯誤碼。 以下是其中一個可能的值。
傳回碼 | Description |
---|---|
|
lpszInterfaceName 所指向的緩衝區不夠大,無法保存結果。 lpcchInterfaceName 參數會傳回結果中的字元數,不包括終止 NULL。 |
備註
請注意, lpcchInterfaceName 是指字元計數,而不是位元組計數,而且傳回的大小不包含計數中的終止 NULL 。 如需調整緩衝區大小的詳細資訊,請參閱 數據大小慣例。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | 都不支援 |
最低支援的伺服器 | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
目標平台 | Windows |
標頭 | clusapi.h |
程式庫 | ClusAPI.lib |
Dll | ClusAPI.dll |