GetNodeClusterState-Funktion (clusapi.h)

Bestimmt, ob der Clusterdienst installiert ist und auf einem Knoten ausgeführt wird. Der PCLUSAPI_GET_NODE_CLUSTER_STATE Typ definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in, optional] lpszNodeName

Zeiger auf eine Unicode-Zeichenfolge mit NULL-Beendigung, die den Namen des abzufragenden Knotens enthält. Wenn lpszNodeNameNULL ist, wird der lokale Knoten abgefragt.

[out] pdwClusterState

Zeiger auf einen Wert, der den Status des Clusterdiensts auf dem Knoten beschreibt. Ein Knoten wird durch einen der folgenden NODE_CLUSTER_STATE Enumerationswerte beschrieben.

ClusterStateNotInstalled (0)

Der Clusterdienst ist nicht auf dem Knoten installiert.

ClusterStateNotConfigured (1)

Der Clusterdienst ist auf dem Knoten installiert, aber noch nicht konfiguriert.

ClusterStateNotRunning (3)

Der Clusterdienst wird auf dem Knoten installiert und konfiguriert, wird aber derzeit nicht ausgeführt.

ClusterStateRunning (19 (0x13))

Der Clusterdienst wird auf dem Knoten installiert, konfiguriert und ausgeführt.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS (0) zurück. Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück.

Hinweise

Hinweis Die GetNodeClusterState-Funktion unterstützt keinen 64-Bit-Windows-basierten Knoten , wenn die aufrufende Anwendung 32-Bit-Windows-basiert ist.

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

NODE_CLUSTER_STATE

Knotenverwaltungsfunktionen