Funzione ClusterGroupEnum (clusapi.h)
Enumera le risorse in un gruppo o i nodi che sono i proprietari preferiti di un gruppo, restituendo il nome della risorsa o del nodo con ogni chiamata. Il tipo PCLUSAPI_CLUSTER_GROUP_ENUM definisce un puntatore a questa funzione.
Sintassi
DWORD ClusterGroupEnum(
[in] HGROUPENUM hGroupEnum,
[in] DWORD dwIndex,
[out] LPDWORD lpdwType,
[out] LPWSTR lpszResourceName,
[in, out] LPDWORD lpcchName
);
Parametri
[in] hGroupEnum
Handle di enumerazione di gruppo restituito dalla funzione ClusterGroupOpenEnum .
[in] dwIndex
Indice della risorsa o del nodo da restituire. Questo parametro deve essere zero per la prima chiamata a ClusterGroupEnum e quindi incrementato per le chiamate successive.
[out] lpdwType
Puntatore al tipo di oggetto restituito da ClusterGroupEnum. Di seguito sono riportati valori validi dell'enumerazione CLUSTER_GROUP_ENUM .
CLUSTER_GROUP_ENUM_CONTAINS (1)
L'oggetto è una delle risorse nel gruppo.
CLUSTER_GROUP_ENUM_NODES (2)
L'oggetto è uno dei nodi nell'elenco dei proprietari preferiti del gruppo.
[out] lpszResourceName
Puntatore a una stringa Unicode con terminazione Null contenente il nome della risorsa o del nodo restituito.
[in, out] lpcchName
Puntatore alla dimensione del buffer lpszResourceName come numero di 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, escluso il valore NULL di terminazione.
Valore restituito
La funzione può restituire uno dei valori seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
Operazione riuscita. |
|
sono disponibili più dati. Questo valore viene restituito se il buffer a cui punta lpszResourceName non è sufficiente per contenere il risultato. Il parametro lpcchName restituisce il numero di caratteri nel risultato, escluso il valore NULL di terminazione. |
|
Dati disponibili esauriti. Questo valore viene restituito se non sono presenti più risorse o nodi da restituire. |
Se l'operazione non è riuscita a causa di un problema diverso da quelli descritti con i valori ERROR_NO_MORE_ITEMS o ERROR_MORE_DATA , ClusterGroupEnum restituisce un codice di errore di sistema.
Commenti
Si noti che lpcchName fa riferimento a un conteggio di caratteri e non a un conteggio di byte e che le dimensioni restituite non includono il valore NULL di terminazione nel conteggio. Per altre informazioni sul ridimensionamento dei buffer, vedere Convenzioni delle dimensioni dei dati.
Non chiamare ClusterGroupEnum da alcuna funzione del punto di ingresso della DLL della risorsa. ClusterGroupEnum può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.
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 |