Funzione GetClusterGroupState (clusapi.h)

Articolo
08/22/2023

Restituisce lo stato corrente di un gruppo. Il tipo PCLUSAPI_GET_CLUSTER_GROUP_STATE definisce un puntatore a questa funzione.

Sintassi

CLUSTER_GROUP_STATE GetClusterGroupState(
  [in]                HGROUP  hGroup,
  [out, optional]     LPWSTR  lpszNodeName,
  [in, out, optional] LPDWORD lpcchNodeName
);

Parametri

[in] hGroup

Handle al gruppo per cui devono essere restituite le informazioni sullo stato.

[out, optional] lpszNodeName

Puntatore a una stringa Unicode con terminazione Null contenente il nome del nodo proprietario del gruppo.

[in, out, optional] lpcchNodeName

Puntatore alla dimensione del buffer lpszNodeName 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

GetClusterGroupState restituisce lo stato corrente del gruppo, rappresentato da uno dei valori seguenti.

Codice/valore restituito	Descrizione
ClusterGroupStateUnknown -1	L'operazione non è riuscita. Per altre informazioni sull'errore, chiamare la funzione GetLastError.
ClusterGroupOnline 0	Tutte le risorse nel gruppo sono online.
ClusterGroupOffline 1	Tutte le risorse nel gruppo sono offline o non sono presenti risorse nel gruppo.
ClusterGroupFailed 2	Almeno una risorsa nel gruppo non è riuscita (impostare uno stato di ClusterResourceFaileddall'enumerazione CLUSTER_RESOURCE_STATE ).
ClusterGroupPartialOnline 3	Almeno una risorsa del gruppo è in linea. Nessuna risorsa in sospeso o non riuscita.
ClusterGroupPending 4	Almeno una risorsa del gruppo è in stato di attesa. Non sono presenti risorse in errore.

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 GetClusterGroupState da qualsiasi funzione del punto di ingresso della DLL della risorsa. GetClusterGroupState può essere chiamato in modo sicuro da un thread di lavoro. Per altre informazioni, vedere Chiamate di funzione da evitare nelle DLL delle risorse.

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

Vedi anche

CLUSTER_GROUP_STATE

CLUSTER_RESOURCE_STATE

Funzioni di gestione dei gruppi

OpenClusterGroup

Condividi tramite