GetClusterNodeState, fonction (clusapi.h)

  • Article

Retourne l’état actuel d’un nœud. Le type PCLUSAPI_GET_CLUSTER_NODE_STATE définit un pointeur vers cette fonction.

Syntaxe

CLUSTER_NODE_STATE GetClusterNodeState(
  [in] HNODE hNode
);

Paramètres

[in] hNode

Gérez le nœud pour lequel les informations d’état doivent être retournées.

Valeur retournée

GetClusterNodeState retourne l’état actuel du nœud, qui est représenté par l’une des valeurs suivantes.

Les valeurs retournées proviennent de l’énumération CLUSTER_NODE_STATE .

Code/valeur de retour Description
ClusterNodeUp
0
 Le nœud est physiquement branché, activé, démarré et capable d’exécuter des programmes.
ClusterNodeDown
1
 Le nœud est désactivé ou n’est pas opérationnel.
ClusterNodeJoining
3
 Le nœud est en cours de jonction d’un cluster.
ClusterNodePaused
2
 Le nœud est en cours d’exécution, mais ne participe pas aux opérations de cluster.
ClusterNodeStateUnknown
-1
 L’opération n’a pas réussi. Pour plus d’informations sur l’erreur, appelez la fonction GetLastError.

Remarques

L’état ClusterNodeDown indique uniquement qu’un nœud est inactif ; elle ne spécifie pas la raison de l’inactivité. Un nœud peut être à l’état ClusterNodeDown pour les raisons suivantes :

  • Le nœud n’est pas en cours d’exécution.
  • Le service de cluster sur le nœud n’est pas en cours d’exécution.
  • Le nœud ne peut pas communiquer avec le nœud qui contrôle la ressource de quorum.
  • Le nœud est inactif pour toute autre raison.
Lorsqu’un nœud fonctionne en tant que membre actif d’un cluster mais ne peut pas héberger de ressources ou de groupes, il est dans l’état ClusterNodePaused (voir la fonction PauseClusterNode ). Les nœuds qui font l’objet d’une maintenance sont généralement placés dans cet état.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Aucun pris en charge
Serveur minimal pris en charge Windows Server 2008 Entreprise, Windows Server 2008 Datacenter
Plateforme cible Windows
En-tête clusapi.h
Bibliothèque ClusAPI.lib
DLL ClusAPI.dll

Voir aussi

CLUSTER_NODE_STATE

OpenClusterNode

PauseClusterNode