ChangeClusterResourceGroup-Funktion (clusapi.h)

Verschiebt eine Ressource von einer Gruppe in eine andere. Der PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD ChangeClusterResourceGroup(
  [in] HRESOURCE hResource,
  [in] HGROUP    hGroup
);

Parameter

[in] hResource

Handle der zu verschiebenden Ressource.

[in] hGroup

Handle der Gruppe, die die von hResource identifizierte Ressource empfangen soll.

Rückgabewert

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

Wenn die Funktion fehlschlägt, gibt sie einen der Systemfehlercodes zurück.

Hinweise

Mit der ChangeClusterResourceGroup-Funktion müssen sowohl die Gruppe, zu der eine Ressource derzeit gehört, als auch ihre neue Gruppe unabhängig vom Status der Ressource demselben Knoten gehören.

Rufen Sie ChangeClusterResourceGroup nicht über eine Ressourcen-DLL auf. Weitere Informationen finden Sie unter Zu vermeidende Funktionsaufrufe in Ressourcen-DLLs. Wenn die von hResourceidentifizierte Ressource Abhängigkeiten aufweist, werden alle Ressourcen in der Abhängigkeitsstruktur in die von hGroup identifizierte Gruppe verschoben. In der im folgenden Diagramm dargestellten Situation wird beispielsweise durch das Ändern von Ressource B in Gruppe 2 die gesamte Abhängigkeitsstruktur (Ressourcen A, X und Y) verschoben.

Ü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 zum Erstellen 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

OpenClusterResource