Funzione GetClusterNodeState (clusapi.h)

Restituisce lo stato corrente di un nodo. Il tipo PCLUSAPI_GET_CLUSTER_NODE_STATE definisce un puntatore a questa funzione.

Sintassi

CLUSTER_NODE_STATE GetClusterNodeState(
  [in] HNODE hNode
);

Parametri

[in] hNode

Handle per il nodo per cui devono essere restituite le informazioni sullo stato.

Valore restituito

GetClusterNodeState restituisce lo stato corrente del nodo, rappresentato da uno dei valori seguenti.

I valori restituiti provengono dall'enumerazione CLUSTER_NODE_STATE .

Codice/valore restituito	Descrizione
ClusterNodeUp 0	Il nodo è collegato fisicamente, attivato, avviato e in grado di eseguire programmi.
ClusterNodeDown 1	Il nodo è disattivato o non operativo.
ClusterNodeJoining 3	Il nodo è in fase di aggiunta a un cluster.
ClusterNodePaused 2	Il nodo è in esecuzione ma non partecipa alle operazioni del cluster.
ClusterNodeStateUnknown -1	L'operazione non è riuscita. Per altre informazioni sull'errore, chiamare la funzione GetLastError.

Commenti

Lo stato ClusterNodeDown indica solo che un nodo è inattivo; non specifica il motivo dell'inattività. Un nodo può trovarsi nello stato ClusterNodeDown per i motivi seguenti:

• Il nodo non è in esecuzione.
• Il servizio cluster nel nodo non è in esecuzione.
• Il nodo non può comunicare con il nodo che controlla la risorsa quorum.
• Il nodo è inattivo per qualsiasi altro motivo.

Quando un nodo funziona come membro attivo di un cluster, ma non può ospitare risorse o gruppi, si trova nello stato ClusterNodePaused (vedere la funzione PauseClusterNode ). I nodi in fase di manutenzione vengono in genere posizionati in questo stato.

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_NODE_STATE

OpenClusterNode

PauseClusterNode