Funzione ClusterOpenEnum (clusapi.h)

Articolo
03/08/2023

Apre un enumeratore per scorrere gli oggetti cluster in un cluster. Il tipo PCLUSAPI_CLUSTER_OPEN_ENUM definisce un puntatore a questa funzione.

Sintassi

HCLUSENUM ClusterOpenEnum(
  [in] HCLUSTER hCluster,
  [in] DWORD    dwType
);

Parametri

[in] hCluster

Handle per un cluster.

[in] dwType

Maschera di bit che descrive il tipo di oggetti da enumerare. Uno o più dei valori seguenti dell'enumerazione CLUSTER_ENUM sono validi.

CLUSTER_ENUM_NODE (1 (0x1))

Enumera i nodi nel cluster.

CLUSTER_ENUM_RESTYPE (2 (0x2))

Enumera i tipi di risorsa nel cluster.

CLUSTER_ENUM_RESOURCE (4 (0x4))

Enumera le risorse nel cluster.

CLUSTER_ENUM_GROUP (8 (0x8))

Enumera i gruppi nel cluster.

CLUSTER_ENUM_NETWORK (16 (0x10))

Enumera le reti nel cluster.

CLUSTER_ENUM_NETINTERFACE (32 (0x20))

Enumera le interfacce di rete nel cluster.

CLUSTER_ENUM_SHARED_VOLUME_RESOURCE (1073741824 (0x40000000))

Enumera i volumi condivisi del cluster usati dal cluster.

Nota A differenza della maggior parte delle altre maschera di bit di enumerazione, questo valore deve essere usato da solo. Non usare l'operatore OR per combinarlo con altre maschera di bit.

Windows Server 2008: Il valore CLUSTER_ENUM_SHARED_VOLUME_RESOURCE non è supportato prima di Windows Server 2008 R2.

CLUSTER_ENUM_INTERNAL_NETWORK (2147483648 (0x80000000))

Enumera le reti usate dal cluster per la comunicazione interna. Le reti vengono enumerate in ordine di priorità più alta a quella più bassa, come stabilito da SetClusterNetworkPriorityOrder.

Nota A differenza della maggior parte delle altre maschera di bit di enumerazione, questo valore deve essere usato da solo. Non usare l'operatore OR per combinarlo con altre maschera di bit.

CLUSTER_ENUM_ALL ((CLUSTER_ENUM_NODE | CLUSTER_ENUM_RESTYPE | CLUSTER_ENUM_RESOURCE | CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NETWORK | CLUSTER_ENUM_NETINTERFACE))

Enumera tutti gli oggetti cluster.

Valore restituito

Se l'operazione ha esito positivo, ClusterOpenEnum restituisce un handle a un enumeratore cluster.

Se l'operazione non riesce, la funzione restituisce NULL. Per altre informazioni sull'errore, chiamare la funzione GetLastError.

Commenti

Le applicazioni chiamano la funzione ClusterOpenEnum per creare un particolare tipo di enumeratore. ClusterOpenEnum può creare enumeratori per l'iterazione tra gruppi, nodi, tipi di risorse, risorse o tutti questi. Ad esempio, un'applicazione può chiamare ClusterOpenEnum per ottenere un'enumerazione di tutti i nodi e gruppi in un cluster specificando CLUSTER_ENUM_GROUP | CLUSTER_ENUM_NODE nel parametro dwType . ClusterOpenEnum restituisce un handle che può essere passato a ClusterEnum per accedere a ognuno dei gruppi o nodi del cluster e a ClusterCloseEnum per rilasciare l'enumeratore.

Esempio

Vedere Enumerazione degli oggetti.

Requisiti

Requisito	Valore
Client minimo supportato	Nessuno supportato
Server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Piattaforma di destinazione	Windows
Intestazione	clusapi.h
Libreria	ClusAPI.lib
DLL	ClusAPI.dll

Vedi anche

Funzioni di gestione del cluster

ClusterCloseEnum

ClusterEnum

SetClusterNetworkPriorityOrder

Condividi tramite