PCLUSAPI_CLUSTER_OPEN_ENUM
コールバックシグネチャ
HCLUSENUM PCLUSAPI_CLUSTER_OPEN_ENUM(
HCLUSTER hCluster,
DWORD dwType
);パラメーター
| フィールド | 型 | 説明 |
|---|---|---|
| hCluster | HCLUSTER | クラスターのハンドルです。 |
| dwType | DWORD | 列挙するオブジェクトの種類を表すビットマスクです。次の 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 演算子を使って他のビットマスクと組み合わせないでください。
CLUSTER_ENUM_INTERNAL_NETWORK (2147483648 (0x80000000))クラスターが内部通信に使用するネットワークを列挙します。ネットワークは、 SetClusterNetworkPriorityOrder で設定された優先度の高い順に列挙されます。 注 他のほとんどの列挙用ビットマスクとは異なり、この値は単独で使用する必要があります。
OR 演算子を使って他のビットマスクと組み合わせないでください。
CLUSTER_ENUM_ALL ((CLUSTER_ENUM_NODE | CLUSTER_ENUM_RESTYPE | CLUSTER_ENUM_RESOURCE | CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NETWORK | CLUSTER_ENUM_NETINTERFACE))すべてのクラスターオブジェクトを列挙します。 |
公式ドキュメント
クラスター内の クラスターオブジェクトを 反復処理するための列挙子を開きます。 PCLUSAPI_CLUSTER_OPEN_ENUM 型は、この関数へのポインターを定義します。
戻り値
操作が成功すると、ClusterOpenEnum は クラスター列挙子のハンドルを返します。
操作が失敗した場合、この関数は NULL を返します。エラーの詳細については、 GetLastError 関数を呼び出してください。
解説(Remarks)
アプリケーションは、特定の種類の列挙子を作成するために ClusterOpenEnum 関数を
呼び出します。
ClusterOpenEnum は、グループ、ノード、リソースの種類、リソース、またはそれらすべてを反復処理するための
列挙子を作成できます。たとえば、アプリケーションは dwType パラメーターに
CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NODE を指定して
ClusterOpenEnum を呼び出すことで、クラスター内のすべてのノードとグループの列挙を取得できます。
ClusterOpenEnum が返すハンドルは、各クラスターグループまたはノードにアクセスするために ClusterEnum に渡したり、列挙子を解放するために
ClusterCloseEnum に渡したりできます。
例
オブジェクトの列挙を参照してください。
Microsoft 公式リファレンス: 英語 (en-us) · 日本語 (ja-jp) · 原文ソース (GitHub)