Condividi tramite


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