Share via

GetClusterNodeState-Funktion (clusapi.h)

  • Artikel

Gibt den aktuellen Status eines Knotens zurück. Der PCLUSAPI_GET_CLUSTER_NODE_STATE-Typs definiert einen Zeiger auf diese Funktion.

Syntax

CLUSTER_NODE_STATE GetClusterNodeState(
  [in] HNODE hNode
);

Parameter

[in] hNode

Behandeln Sie den Knoten, für den Zustandsinformationen zurückgegeben werden sollen.

Rückgabewert

GetClusterNodeState gibt den aktuellen Status des Knotens zurück, der durch einen der folgenden Werte dargestellt wird.

Die zurückgegebenen Werte stammen aus der CLUSTER_NODE_STATE-Enumeration .

Rückgabecode/-wert BESCHREIBUNG
ClusterNodeUp
0
 Der Knoten ist physisch angeschlossen, aktiviert, gestartet und kann Programme ausführen.
ClusterNodeDown
1
 Der Knoten ist deaktiviert oder nicht betriebsbereit.
ClusterNodeJoining
3
 Der Knoten ist gerade dabei, einem Cluster zu beitreten.
ClusterNodePaused
2
 Der Knoten wird ausgeführt, ist aber nicht an Clustervorgängen beteiligt.
ClusterNodeStateUnknown
-1
 Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten.

Hinweise

Der ClusterNodeDown-Zustand gibt nur an, dass ein Knoten inaktiv ist. Der Grund für die Inaktivität wird nicht angegeben. Ein Knoten kann sich aus den folgenden Gründen im Status ClusterNodeDown befinden:

  • Der Knoten wird nicht ausgeführt.
  • Der Clusterdienst auf dem Knoten wird nicht ausgeführt.
  • Der Knoten kann nicht mit dem Knoten kommunizieren, der die Quorumressource steuert.
  • Der Knoten ist aus einem anderen Grund inaktiv.
Wenn ein Knoten als aktives Mitglied eines Clusters ausgeführt wird, aber keine Ressourcen oder Gruppen hosten kann, befindet er sich im Status ClusterNodePaused (siehe die Funktion PauseClusterNode ). Knoten, die gewartet werden, befinden sich in der Regel in diesem Zustand.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Nicht unterstützt
Unterstützte Mindestversion (Server) Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
Zielplattform Windows
Kopfzeile clusapi.h
Bibliothek ClusAPI.lib
DLL ClusAPI.dll

Weitere Informationen

CLUSTER_NODE_STATE

OpenClusterNode

PauseClusterNode