GetClusterResourceState-Funktion (clusapi.h)
Gibt den aktuellen Zustand einer Ressource zurück. Der PCLUSAPI_GET_CLUSTER_RESOURCE_STATE Typ definiert einen Zeiger auf diese Funktion.
Syntax
CLUSTER_RESOURCE_STATE GetClusterResourceState(
[in] HRESOURCE hResource,
[out, optional] LPWSTR lpszNodeName,
[in, out, optional] LPDWORD lpcchNodeName,
[out, optional] LPWSTR lpszGroupName,
[in, out, optional] LPDWORD lpcchGroupName
);
Parameter
[in] hResource
Handle zum Angeben der Ressource, für die Zustandsinformationen zurückgegeben werden sollen.
[out, optional] lpszNodeName
Zeiger auf einen Puffer, der den Namen des aktuellen Besitzerknotens der angegebenen Ressource als MIT NULL beendete Unicode-Zeichenfolge empfängt. Übergeben Sie NULL , wenn der Knotenname nicht erforderlich ist.
[in, out, optional] lpcchNodeName
Zeiger auf die Größe des lpszNodeName-Puffers als Anzahl von Zeichen. Dieser Zeiger darf nicht NULL sein, es sei denn , lpszNodeName ist ebenfalls NULL. Gibt bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich des beendenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der abschließende NULL-Wert ausgeschlossen wird.
[out, optional] lpszGroupName
Zeiger auf einen Puffer, der den Namen der Gruppe empfängt, die die angegebene Ressource enthält. Der Name wird als MIT NULL endende Unicode-Zeichenfolge zurückgegeben. Übergeben Sie NULL , wenn der Gruppenname nicht erforderlich ist.
[in, out, optional] lpcchGroupName
Zeiger auf die Größe des puffers lpszGroupName als Anzahl von Zeichen. Dieser Zeiger darf nicht NULL sein, es sei denn , lpszNodeName ist ebenfalls NULL. Gibt bei der Eingabe die maximale Anzahl von Zeichen an, die der Puffer enthalten kann, einschließlich des beendenden NULL. Gibt bei der Ausgabe die Anzahl der Zeichen im resultierenden Namen an, wobei der abschließende NULL-Wert ausgeschlossen wird.
Rückgabewert
GetClusterResourceState gibt den aktuellen Zustand der Ressource zurück, die aus der CLUSTER_RESOURCE_STATE Enumeration aufgezählt wurde, die durch einen der folgenden Werte dargestellt werden kann.
| Rückgabecode/-wert | BESCHREIBUNG |
|---|---|
|
Die Ressource führt die Initialisierung durch. |
|
Die Ressource ist betriebsbereit und funktioniert normal. |
|
Die Ressource ist nicht betriebsbereit. Dieser Wert wird zurückgegeben, wenn die Ressource den Status ClusterResourceOffline (3) oder ClusterResourceCannotComeOnlineOnThisNode (127) gemeldet hat. |
|
Bei der Ressource ist ein Fehler aufgetreten. Dieser Wert wird zurückgegeben, wenn die Ressource den Status ClusterResourceFailed (4) oder ClusterResourceCannotComeOnlineOnAnyNode (126) gemeldet hat. |
|
Die Ressource wird gerade online oder offline geschaltet. |
|
Die Ressource wird gerade online geschaltet. |
|
Die Ressource wird gerade offline geschaltet. |
|
Der Vorgang war nicht erfolgreich. Rufen Sie die Funktion GetLastError auf, um weitere Informationen zum Fehler zu erhalten. |
Hinweise
Rufen Sie GetClusterResourceState nicht über eine Ressourcen-DLL-Einstiegspunktfunktion auf. GetClusterResourceState kann sicher von einem Workerthread aufgerufen werden. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.
Beispiele
Ein Beispiel finden Sie unter Abrufen von Objektzuständen .
Anforderungen
| 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 |