ネットワーク インターフェイスに関連付けられているクラスターへのハンドルを返します。 PCLUSAPI_GET_CLUSTER_FROM_NET_INTERFACE型は、この関数へのポインターを定義します。
構文
HCLUSTER GetClusterFromNetInterface(
[in] HNETINTERFACE hNetInterface
);
パラメーター
[in] hNetInterface
ネットワーク インターフェイスへのハンドル。
戻り値
操作が成功した場合、関数はネットワーク インターフェイスを所有するクラスターへのハンドルを返します。
操作が失敗した場合、関数は NULL を返します。 エラーの詳細については、 GetLastError を呼び出します。
注釈
hNetInterface を有効なハンドルにするには、必ず開いているクラスター ハンドルが必要です (「OpenClusterNetInterface」を参照してください)。 GetClusterFromNetInterface は 、hNetInterface が取得されたハンドルの別のインスタンスを返します。
ハンドルがスコープ外になる前に、必ず GetClusterFromNetInterface から返されたハンドルで CloseCluster を呼び出してください。 このハンドルを閉じても、 hNetInterface または hNetInterface が取得されたクラスター ハンドルは無効になりません。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |