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 |