Funzione ClusterResourceEnum (clusapi.h)
Enumera le risorse dipendenti di una risorsa , i nodi o entrambi. Restituisce il nome di un oggetto cluster con ogni chiamata. Il tipo di PCLUSAPI_CLUSTER_RESOURCE_ENUM definisce un puntatore a questa funzione.
Sintassi
DWORD ClusterResourceEnum(
[in] HRESENUM hResEnum,
[in] DWORD dwIndex,
[out] LPDWORD lpdwType,
[out] LPWSTR lpszName,
[in, out] LPDWORD lpcchName
);
Parametri
[in] hResEnum
Handle di enumerazione delle risorse restituito dalla funzione ClusterResourceOpenEnum .
[in] dwIndex
Indice dell'oggetto risorsa o nodo da restituire. Questo parametro deve essere zero per la prima chiamata alla funzione ClusterResourceEnum e quindi incrementata per le chiamate successive.
[out] lpdwType
Tipo di oggetto restituito da ClusterResourceEnum.
I valori possibili sono uno dei valori di enumerazione seguenti CLUSTER_RESOURCE_ENUM :
CLUSTER_RESOURCE_ENUM_DEPENDS (1)
L'oggetto è una risorsa e hResEnum è una risorsa che dipende da questo oggetto.
CLUSTER_RESOURCE_ENUM_PROVIDES (2)
L'oggetto è una risorsa che dipende dalla risorsa identificata da hResEnum.
CLUSTER_RESOURCE_ENUM_NODES (4)
L'oggetto è un nodo che può ospitare la risorsa identificata da hResEnum.
[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 di caratteri. In input specificare il numero massimo di caratteri che il buffer può contenere, incluso il carattere null terminante. Nell'output specifica il numero di caratteri nel nome risultante, escluso il carattere null terminante.
Valore restituito
La funzione restituisce uno dei valori seguenti.
| Codice/valore restituito | Descrizione |
|---|---|
|
L'operazione è stata completata correttamente o il parametro lpszName è NULL. |
|
Il buffer a cui punta il parametro lpszName non è abbastanza grande per contenere il risultato. Il parametro lpcchName restituisce il numero di caratteri nel risultato, escluso il carattere null terminante. |
|
Non sono più oggetti da restituire. |
| Qualsiasi altro codice di errore restituito indica che l'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 carattere Null terminante nel conteggio. Per altre informazioni sul ridimensionamento dei buffer, vedere Convenzioni delle dimensioni dei dati.
Non chiamare ClusterResourceEnum da qualsiasi funzione del punto di ingresso della DLL di risorse. ClusterResourceEnum può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione per 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 |