Partager via


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).

Diagramme montrant l’arborescence des dépendances entre les ressources d’un groupe de ressources de cluster, avant et après le déplacement d’une ressource vers un autre groupe.

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

Voir aussi

OpenCluster

OpenClusterGroup

OpenClusterResource