ChangeClusterResourceGroup, fonction (clusapi.h)
Déplace une ressource d’un groupe à un autre. Le type PCLUSAPI_CHANGE_CLUSTER_RESOURCE_GROUP définit un pointeur vers cette fonction.
Syntaxe
DWORD ChangeClusterResourceGroup(
[in] HRESOURCE hResource,
[in] HGROUP hGroup
);
Paramètres
[in] hResource
Handle de la ressource à déplacer.
[in] hGroup
Handle du groupe qui doit recevoir la ressource identifiée par hResource.
Valeur retournée
Si la fonction réussit, elle retourne ERROR_SUCCESS.
Si la fonction échoue, elle retourne l’un des codes d’erreur système.
Remarques
Avec la fonction ChangeClusterResourceGroup , le groupe auquel appartient actuellement une ressource et son nouveau groupe doivent appartenir au même nœud , quel que soit l’état de la ressource.
N’appelez pas ChangeClusterResourceGroup à partir d’une DLL de ressource. Pour plus d’informations, consultez Appels de fonction à éviter dans les DLL de ressources. Si la ressource identifiée par hResource a des dépendances, toutes les ressources de son arborescence de dépendances sont déplacées vers le groupe identifié par hGroup. Par exemple, dans la situation illustrée dans le diagramme suivant, la modification de la ressource B en groupe 2 déplace l’arborescence de dépendances entière (ressources A, X et Y).
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 |