Funzione ClusterResourceEnumEx (clusapi.h)

Articolo
08/22/2023

Enumera una risorsa e quindi restituisce un puntatore alla risorsa o al nodo dipendente corrente.

Sintassi

DWORD ClusterResourceEnumEx(
  [in]      HRESENUMEX                  hResourceEnumEx,
  [in]      DWORD                       dwIndex,
  [in, out] PCLUSTER_RESOURCE_ENUM_ITEM pItem,
  [in, out] LPDWORD                     cbItem
);

Parametri

[in] hResourceEnumEx

Handle per un'enumerazione di risorse restituita dalla funzione ClusterResourceOpenEnumEx .

[in] dwIndex

Indice dell'oggetto resource o node da restituire. Questo parametro deve essere zero per la prima chiamata alla funzione ClusterResourceEnumEx e quindi essere
incrementato per le chiamate successive.

[in, out] pItem

Puntatore che riceve l'oggetto restituito.

[in, out] cbItem

In input, le dimensioni del parametro 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

La funzione restituisce uno dei valori seguenti.

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'operazione è stata completata correttamente oppure il parametro lpszName è NULL.
ERROR_MORE_DATA 234 (0xEA)	Buffer a cui punta il parametro lpszName non è sufficientemente grande da contenere il risultato. Il parametro lpcchName restituisce il numero di caratteri nel risultato, escluso il carattere null di terminazione.
ERROR_NO_MORE_ITEMS 259 (0x103)	Non sono più presenti oggetti da restituire.
Codice di errore di sistema	Qualsiasi altro codice di errore restituito indica che l'operazione non è riuscita.

Requisiti


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

Vedi anche

ClusterResourceOpenEnumEx

Funzioni di gestione risorse del cluster di failover

Condividi tramite