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 |