AddClusterResourceDependency, fonction (clusapi.h)
Crée une relation de dépendance entre deux ressources. Le type PCLUSAPI_ADD_CLUSTER_RESOURCE_DEPENDENCY définit un pointeur vers cette fonction.
Syntaxe
DWORD AddClusterResourceDependency(
[in] HRESOURCE hResource,
[in] HRESOURCE hDependsOn
);
Paramètres
[in] hResource
Gérez la ressource dépendante.
[in] hDependsOn
Gérez la ressource dont la ressource identifiée par hResource doit dépendre.
Valeur retournée
Si l’opération réussit, elle retourne ERROR_SUCCESS (0).
Si l’opération échoue, AddClusterResourceDependency retourne l’un des codes d’erreur système. Voici les valeurs de retour possibles.
| Code/valeur de retour | Description |
|---|---|
|
Une ressource dépend d’elle-même. |
|
La dépendance de ressource existe déjà. |
|
La ressource dépendante est le quorum. |
|
Les ressources ne se trouvent pas dans le même groupe. |
|
Au moins une des ressources est marquée pour suppression. |
|
La ressource dépendante est déjà en ligne. |
Remarques
Une relation de dépendance créée par la fonction AddClusterResourceDependency affecte la façon dont les ressources sont déplacées d’un nœud à un autre après une défaillance. Il détermine l’ordre dans lequel les ressources sont mises hors connexion et remises en ligne.
Les ressources d’une relation de dépendance doivent être déplacées ensemble. La ressource dépendante doit être mise en ligne après la ressource dont elle dépend.
Les deux ressources identifiées par hResource et hDependsOn doivent se trouver dans le même groupe.
N’appelez pas AddClusterResourceDependency si hResource est déjà en ligne. L’appel échoue avec une erreur ERROR_RESOURCE_ONLINE . Notez que ce comportement a changé avec Windows Server 2008. Vous pouvez appeler AddClusterResourceDependency et modifier les dépendances de ressources sans nécessiter la mise hors connexion de la ressource.
N’appelez pas AddClusterResourceDependency à partir d’une DLL de ressource. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources.
Ne passez pas de handles LPC et RPC au même appel de fonction. Sinon, l’appel déclenche une exception RPC et peut avoir des effets destructeurs supplémentaires. Pour plus d’informations sur la création des handles LPC et RPC, consultez Using Object Handles and OpenCluster.
Configuration requise
| Condition requise | Valeur |
|---|---|
| Client minimal pris en charge | Aucun pris en charge |
| Serveur minimal pris en charge | Windows Server 2008 Entreprise, Windows Server 2008 Datacenter |
| Plateforme cible | Windows |
| En-tête | clusapi.h |
| Bibliothèque | ClusAPI.lib |
| DLL | ClusAPI.dll |