Funzione ClusterResourceTypeEnum (clusapi.h)

Articolo
02/23/2024

Enumera i possibili nodi o le risorse di un tipo di risorsa, che restituisce il nome di un nodo o di una risorsa per ogni chiamata. Il tipo PCLUSAPI_CLUSTER_RESOURCE_TYPE_ENUM definisce un puntatore a questa funzione.

Sintassi

DWORD ClusterResourceTypeEnum(
  [in]      HRESTYPEENUM hResTypeEnum,
  [in]      DWORD        dwIndex,
  [out]     LPDWORD      lpdwType,
  [out]     LPWSTR       lpszName,
  [in, out] LPDWORD      lpcchName
);

Parametri

[in] hResTypeEnum

Handle di enumerazione del tipo di risorsa restituito da ClusterResourceTypeOpenEnum.

[in] dwIndex

Indice dell'oggetto risorsa o nodo da restituire. Questo parametro deve essere zero per la prima chiamata a ClusterResourceTypeEnum e quindi incrementato per le chiamate successive.

[out] lpdwType

Tipo di oggetto restituito da ClusterResourceTypeEnum. I valori seguenti dell'enumerazione CLUSTER_RESOURCE_TYPE_ENUM sono validi.

CLUSTER_RESOURCE_TYPE_ENUM_NODES (1)

L'oggetto è un nodo che può essere un possibile proprietario del tipo di risorsa.

CLUSTER_RESOURCE_TYPE_ENUM_RESOURCES (2)

L'oggetto è una risorsa che è un'istanza del tipo di risorsa.

[out] lpszName

Puntatore a una stringa Unicode con terminazione null contenente il nome dell'oggetto restituito.

[in, out] lpcchName

Puntatore alla dimensione del buffer lpszName come conteggio dei caratteri. In input specificare il numero massimo di caratteri che il buffer può contenere, incluso il valore NULL di terminazione. Nell'output specifica il numero di caratteri nel nome risultante, escluse le terminazioni NULL.

Valore restituito

La funzione restituisce uno dei valori seguenti.

Codice/valore restituito	Descrizione
ERROR_SUCCESS 0	L'operazione è stata completata.
ERROR_NO_MORE_ITEMS 259	Non sono più oggetti da restituire.
ERROR_MORE_DATA 234	Il buffer a cui punta lpszName non è abbastanza grande per contenere il risultato. Il parametro lpcchName restituisce il numero di caratteri nel risultato, escluso il valore NULL terminante.
Codice errore di sistema	Operazione non riuscita.

Commenti

Si noti che lpcchName fa riferimento a un conteggio di caratteri e non a un conteggio di byte e che la dimensione restituita non include il valore NULL terminante nel conteggio. Per altre informazioni sul ridimensionamento dei buffer, vedere Convenzioni delle dimensioni dei dati.

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