ClusterOpenEnum 関数 (clusapi.h)
クラスター内の クラスター オブジェクト を反復処理するための列挙子を開 きます。 PCLUSAPI_CLUSTER_OPEN_ENUM型は、この関数へのポインターを定義します。
構文
HCLUSENUM ClusterOpenEnum(
[in] HCLUSTER hCluster,
[in] DWORD dwType
);
パラメーター
[in] hCluster
クラスターへのハンドル。
[in] dwType
列挙するオブジェクトの種類を表すビットマスク。 CLUSTER_ENUM列挙の次の値のうち 1 つ以上が有効です。
CLUSTER_ENUM_NODE (1 (0x1))
クラスター内の ノード を列挙します。
CLUSTER_ENUM_RESTYPE (2 (0x2))
クラスター内の リソースの種類 を列挙します。
CLUSTER_ENUM_RESOURCE (4 (0x4))
クラスター内の リソース を列挙します。
CLUSTER_ENUM_GROUP (8 (0x8))
クラスター内の グループ を列挙します。
CLUSTER_ENUM_NETWORK (16 (0x10))
クラスター内の ネットワーク を列挙します。
CLUSTER_ENUM_NETINTERFACE (32 (0x20))
クラスター内の ネットワーク インターフェイス を列挙します。
CLUSTER_ENUM_SHARED_VOLUME_RESOURCE (1073741824 (0x40000000))
クラスターによって使用されるクラスター共有ボリュームを列挙します。
CLUSTER_ENUM_INTERNAL_NETWORK (2147483648 (0x80000000))
クラスターが内部通信に使用するネットワークを列挙します。 ネットワークは、 SetClusterNetworkPriorityOrder によって確立された優先順位が最も高い順に列挙されます。
CLUSTER_ENUM_ALL ((CLUSTER_ENUM_NODE |CLUSTER_ENUM_RESTYPE |CLUSTER_ENUM_RESOURCE |CLUSTER_ENUM_GROUP |CLUSTER_ENUM_NETWORK |CLUSTER_ENUM_NETINTERFACE))
すべてのクラスター オブジェクトを列挙します。
戻り値
操作が成功すると、 ClusterOpenEnum はクラスター列挙子にハンドルを返します。
操作が失敗した場合、関数は NULL を返します。 エラーの詳細については、 GetLastError 関数を呼び出します。
注釈
アプリケーションは ClusterOpenEnum 関数を呼び出して、特定の種類の列挙子を作成します。
ClusterOpenEnum は、グループ、ノード、リソースの種類、リソース、またはこれらのすべてを反復処理するための列挙子を作成できます。 たとえば、アプリケーションは ClusterOpenEnum を呼び出して、dwType パラメーターで を指定CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NODEすることで、クラスター内のすべてのノードとグループの列挙を取得できます。
ClusterOpenEnum は、 ClusterEnum に渡して各クラスター グループまたはノードにアクセスし、 ClusterCloseEnum に渡して列挙子を解放できるハンドルを返します。
例
「 オブジェクトの列挙」を参照してください。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | サポートなし |
| サポートされている最小のサーバー | Windows Server 2008 Enterprise、Windows Server 2008 Datacenter |
| 対象プラットフォーム | Windows |
| ヘッダー | clusapi.h |
| Library | ClusAPI.lib |
| [DLL] | ClusAPI.dll |