AddClusterResourceDependency-Funktion (clusapi.h)
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 |
|---|---|
|
Eine Ressource hängt von sich selbst ab. |
|
Die Ressourcenabhängigkeit ist bereits vorhanden. |
|
Die abhängige Ressource ist das Quorum. |
|
Die Ressourcen befinden sich nicht in derselben Gruppe. |
|
Mindestens eine der Ressourcen ist zum Löschen markiert. |
|
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 |