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 |