ClusterOpenEnum 関数 (clusapi.h)

[アーティクル]
02/23/2024

クラスター内のクラスターオブジェクトを反復処理するための列挙子を開きます。 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))

クラスターによって使用されるクラスター共有ボリュームを列挙します。

メモ他のほとんどの列挙ビットマスクとは異なり、この値は単独で使用する必要があります。 OR 演算子を使用して他のビットマスクと組み合わせないでください。

Windows Server 2008: CLUSTER_ENUM_SHARED_VOLUME_RESOURCE値は、Windows Server 2008 R2 より前ではサポートされていません。

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

こちらもご覧ください

クラスター管理機能

ClusterCloseEnum

ClusterEnum

SetClusterNetworkPriorityOrder