Funzione ClusterGroupOpenEnum (clusapi.h)

Articolo
07/16/2024

Apre un enumeratore per scorrere le risorsedi un gruppo di e/o i nodi inclusi nell'elenco dei proprietari preferiti. Il tipo PCLUSAPI_CLUSTER_GROUP_OPEN_ENUM definisce un puntatore a questa funzione.

Sintassi

HGROUPENUM ClusterGroupOpenEnum(
  [in] HGROUP hGroup,
  [in] DWORD  dwType
);

Parametri

[in] hGroup

Handle per il gruppo da enumerare.

[in] dwType

Maschera di bit che descrive gli oggetti cluster da enumerare. Di seguito sono riportati i valori validi dell'enumerazione CLUSTER_GROUP_ENUM.

CLUSTER_GROUP_ENUM_CONTAINS (1)

Enumera le risorse nel gruppo.

CLUSTER_GROUP_ENUM_NODES (2)

Enumera i nodi nell'elenco dei proprietari preferiti del gruppo.

CLUSTER_GROUP_ENUM_ALL (3)

Enumera le risorse nel gruppo e i proprietari preferiti del gruppo.

Valore restituito

Se l'operazione ha esito positivo, ClusterGroupOpenEnum restituisce un handle a un enumeratore che può essere passato alla funzione ClusterGroupEnum.

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

Osservazioni

Non chiamare ClusterGroupOpenEnum da qualsiasi funzione del punto di ingresso della DLL della risorsa. ClusterGroupOpenEnum può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere chiamate di funzione per evitare nelle DLL delle risorse.

Esempi

Vedere enumerazione degli oggetti.

Fabbisogno

Requisito	Valore
client minimo supportato	Nessuna supportata
server minimo supportato	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
piattaforma di destinazione	Finestre
intestazione	clusapi.h
libreria	ClusAPI.lib
dll	ClusAPI.dll