AddClusterResourceDependency-Funktion (clusapi.h)

Artikel
02/23/2024

Erstellt eine Abhängigkeitsbeziehung zwischen zwei Ressourcen. Der PCLUSAPI_ADD_CLUSTER_RESOURCE_DEPENDENCY Typ definiert einen Zeiger auf diese Funktion.

Syntax

DWORD AddClusterResourceDependency(
  [in] HRESOURCE hResource,
  [in] HRESOURCE hDependsOn
);

Parameter

[in] hResource

Handle für die abhängige Ressource.

[in] hDependsOn

Handle mit der Ressource, von der die von hResource identifizierte Ressource abhängen soll.

Rückgabewert

Wenn der Vorgang erfolgreich ist, wird ERROR_SUCCESS (0) zurückgegeben.

Wenn der Vorgang fehlschlägt, gibt AddClusterResourceDependency einen der Systemfehlercodes zurück. Im Folgenden sind mögliche Rückgabewerte aufgeführt.

Rückgabecode/-wert	BESCHREIBUNG
ERROR_CIRCULAR_DEPENDENCY 1059 (0x423)	Eine Ressource hängt von sich selbst ab.
ERROR_DEPENDENCY_ALREADY_EXISTS 5003 (0x138B)	Die Ressourcenabhängigkeit ist bereits vorhanden.
ERROR_DEPENDENCY_NOT_ALLOWED 5069 (0x13CD)	Die abhängige Ressource ist das Quorum.
ERROR_INVALID_PARAMETER 87 (0x57)	Die Ressourcen befinden sich nicht in derselben Gruppe.
ERROR_RESOURCE_NOT_AVAILABLE 5006 (0x138E)	Mindestens eine der Ressourcen ist zum Löschen markiert.
ERROR_RESOURCE_ONLINE 5019 (0x139B)	Die abhängige Ressource ist bereits online.

Hinweise

Eine abhängigkeitsbeziehung, die von der AddClusterResourceDependency-Funktion erstellt wird, wirkt sich darauf aus, wie Ressourcen nach einem Fehler von einem Knoten zu einem anderen verschoben werden. Sie bestimmt die Reihenfolge, in der Ressourcen offline geschaltet und wieder online geschaltet werden.

Ressourcen in einer Abhängigkeitsbeziehung müssen zusammen verschoben werden. Die abhängige Ressource muss nach der Ressource, von der sie abhängt, online geschaltet werden.

Die beiden von hResource und hDependsOn identifizierten Ressourcen müssen sich in derselben Gruppe befinden.

Rufen Sie AddClusterResourceDependency nicht auf, wenn hResource bereits online ist. Der Aufruf schlägt mit einem ERROR_RESOURCE_ONLINE Fehler fehl. Beachten Sie, dass sich dieses Verhalten mit Windows Server 2008 geändert hat. Sie können AddClusterResourceDependency aufrufen und Ressourcenabhängigkeiten ändern, ohne dass die Ressource offline geschaltet werden muss.

Rufen Sie AddClusterResourceDependency 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

CanResourceBeDependent

OpenCluster

OpenClusterResource

RemoveClusterResourceDependency

Freigeben über