Funzione ClusterGroupEnumEx (clusapi.h)

Articolo
02/23/2024

Recupera un elemento nell'enumerazione. Il tipo PCLUSAPI_CLUSTER_GROUP_ENUM_EX definisce un puntatore a questa funzione.

Sintassi

DWORD ClusterGroupEnumEx(
  [in]      HGROUPENUMEX             hGroupEnumEx,
  [in]      DWORD                    dwIndex,
  [in, out] PCLUSTER_GROUP_ENUM_ITEM pItem,
  [in, out] LPDWORD                  cbItem
);

Parametri

[in] hGroupEnumEx

Handle per l'enumerazione da cui verrà recuperato l'elemento.

[in] dwIndex

Indice in base zero dell'elemento nell'enumerazione.

[in, out] pItem

Puntatore al buffer da riempire.

[in, out] cbItem

In input, le dimensioni di pItem.

Nell'output, le dimensioni necessarie in byte del buffer se il buffer è troppo piccolo o il numero di byte scritti nel buffer.

Valore restituito

Codice restituito	Descrizione
ERROR_NO_MORE_ITEMS	dwIndex è maggiore del numero di elementi nell'enumerazione.
ERROR_MORE_DATA	Il buffer è troppo piccolo.
ERROR_SUCCESS	Il buffer è stato riempito correttamente.

Commenti

La funzione ClusterGroupEnumEx non si connette al cluster, perché hGroupEnumEx contiene già i dati di enumerazione. I dati vengono copiati nel buffer, ma non vengono recuperati dati dal cluster.

Requisiti

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

Condividi tramite