ClusterOpenEnum 函式 (clusapi.h)
開啟列舉值,以逐一查看叢集中的叢集物件。 PCLUSAPI_CLUSTER_OPEN_ENUM類型會定義此函式的指標。
語法
HCLUSENUM ClusterOpenEnum(
[in] HCLUSTER hCluster,
[in] DWORD dwType
);
參數
[in] hCluster
叢集的句柄。
[in] dwType
位掩碼,描述要列舉的物件類型。 下列一或多個CLUSTER_ENUM列舉值有效。
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) )
列舉所有叢集物件。
傳回值
如果作業成功, 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 |
程式庫 | ClusAPI.lib |
Dll | ClusAPI.dll |