MoveClusterGroup-Funktion (clusapi.h)

Artikel
08/22/2023

Verschiebt eine Gruppe und alle ihre Ressourcen von einem Knoten auf einen anderen. Der PCLUSAPI_MOVE_CLUSTER_GROUP Typ definiert einen Zeiger auf diese Funktion.

Syntax

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

Parameter

[in] hGroup

Handle an die zu verschiebende Gruppe.

[in, optional] hDestinationNode

Handle für den Knoten, auf dem die verschobene Gruppe wieder 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 einen der möglichen Fehlercodes.

Rückgabecode	Beschreibung
ERROR_IO_PENDING	Die Neuzuweisung des Besitzes der Gruppe wird ausgeführt.

Hinweise

Der Rückgabewert der MoveClusterGroup-Funktion impliziert nichts über den Status der Gruppe oder ihrer Ressourcen. Der Rückgabewert gibt nur an, ob der Besitzerwechsel erfolgreich war. Nach der Rückkehr von MoveClusterGroup versucht der Cluster immer, die Gruppe in den Zustand zurückzugeben, den sie vor dem Verschieben hatte.

Wenn Ihre Anwendung nach einer Verschiebung einen bestimmten Zustand für eine Ressource oder eine Gruppe sicherstellen soll:

Überprüfen Sie den Zustand vor der Verschiebung. Der Cluster versucht, diesen Zustand nach der Verschiebung wiederherzustellen.
Rufen Sie den Zustand nach dem Verschieben ab, und passen Sie sie bei Bedarf an. Oder erstellen Sie einen Benachrichtigungsport (siehe Empfangen von Clusterereignissen), und warten Sie auf ein CLUSTER_CHANGE_GROUP_STATE-Ereignis .

Wenn hDestinationNode auf NULL festgelegt ist, versucht MoveClusterGroup , die Gruppe auf den bestmöglichen Knoten zu verschieben. Wenn kein Knoten verfügbar ist, der die Gruppe akzeptieren kann, schlägt die Funktion fehl. MoveClusterGroup schlägt auch fehl, wenn MoveClusterGroup feststellt, dass die Gruppe auf dem Knoten, der durch den hDestinationNode-Parameter identifiziert wird, nicht online geschaltet werden kann.

Rufen Sie MoveClusterGroup nicht aus einer 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

OpenCluster

OpenClusterGroup

OpenClusterNode

Freigeben über