GetNodeClusterState, fonction (clusapi.h)

Détermine si le service de cluster est installé et en cours d’exécution sur un nœud. Le type PCLUSAPI_GET_NODE_CLUSTER_STATE définit un pointeur vers cette fonction.

Syntaxe

DWORD GetNodeClusterState(
  [in, optional] LPCWSTR lpszNodeName,
  [out]          LPDWORD pdwClusterState
);

Paramètres

[in, optional] lpszNodeName

Pointeur vers une chaîne Unicode terminée par null contenant le nom du nœud à interroger. Si lpszNodeName a la valeur NULL, le nœud local est interrogé.

[out] pdwClusterState

Pointeur vers une valeur décrivant l’état du service de cluster sur le nœud. Un nœud est décrit par l’une des valeurs d’énumération NODE_CLUSTER_STATE suivantes.

ClusterStateNotInstalled (0)

Le service cluster n’est pas installé sur le nœud.

ClusterStateNotConfigured (1)

Le service cluster est installé sur le nœud, mais n’a pas encore été configuré.

ClusterStateNotRunning (3)

Le service cluster est installé et configuré sur le nœud, mais il n’est pas en cours d’exécution.

ClusterStateRunning (19 (0x13))

Le service cluster est installé, configuré et en cours d’exécution sur le nœud.

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS (0). Si l’opération échoue, la fonction retourne un code d’erreur système.

Remarques

Note La fonction GetNodeClusterState ne prend pas en charge un nœud Windows 64 bits si l’application appelante est basée sur Windows 32 bits.

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

NODE_CLUSTER_STATE

Fonctions de gestion des nœuds