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 |
|---|---|
|
Ein geeigneter Hostknoten war nicht verfügbar. |
|
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 |