OnlineClusterGroup-Funktion (clusapi.h)

Schaltet eine Gruppe online. Der PCLUSAPI_ONLINE_CLUSTER_GROUP Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD OnlineClusterGroup(
  [in]           HGROUP hGroup,
  [in, optional] HNODE  hDestinationNode
);

Parameter

[in] hGroup

Handle an die Gruppe, die online geschaltet werden soll.

[in, optional] hDestinationNode

Handle für den Knoten , auf dem die von hGroup identifizierte Gruppe online geschaltet werden soll, oder NULL.

Rückgabewert

Wenn der Vorgang erfolgreich ist, gibt die Funktion ERROR_SUCCESS zurück.

Wenn der Vorgang fehlschlägt, gibt die Funktion einen Systemfehlercode zurück. Im Folgenden finden Sie mögliche Fehlercodes.

Rückgabecode	Beschreibung
ERROR_HOST_NODE_NOT_AVAILABLE	Ein geeigneter Hostknoten war nicht verfügbar.
ERROR_IO_PENDING	Der Vorgang wird ausgeführt.

Hinweise

Wenn die Gruppe auf dem Knoten, der durch den hDestinationNode-Parameter identifiziert wird, nicht online geschaltet werden kann, schlägt die OnlineClusterGroup-Funktion fehl.

Wenn der hDestinationNode-Parameter auf NULL festgelegt ist, schaltet OnlineClusterGroup die Gruppe auf dem aktuellen Knoten online.

Rufen Sie OnlineClusterGroup nicht über eine Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs.

Übergeben Sie LPC- und RPC-Handles nicht an denselben Funktionsaufruf. Andernfalls löst der Aufruf eine RPC-Ausnahme aus und kann zusätzliche destruktive Auswirkungen haben. Informationen zur Erstellung von LPC- und RPC-Handles finden Sie unter Verwenden von Objekthandles und OpenCluster.

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

OfflineClusterGroup

OpenCluster

OpenClusterGroup