Partager via


Fonction SetClusterGroupNodeList (clusapi.h)

Définit la liste de nœuds par défaut pour un groupe. Le type PCLUSAPI_SET_CLUSTER_GROUP_NODE_LIST définit un pointeur vers cette fonction.

Syntaxe

DWORD SetClusterGroupNodeList(
  [in] HGROUP   hGroup,
  [in] DWORD    NodeCount,
  [in] HNODE [] NodeList
);

Paramètres

[in] hGroup

Gérez au groupe à affecter la liste des nœuds.

[in] NodeCount

Nombre de nœuds dans la liste identifiée par NodeList.

[in] NodeList

Tableau de handles vers les nœuds, dans l’ordre par préférence, le premier nœud étant le plus préféré et le dernier nœud le moins préféré. Le nombre de nœuds dans le tableau NodeList est contrôlé par le paramètre NodeCount .

Valeur retournée

Si l’opération réussit, la fonction retourne ERROR_SUCCESS.

Si l’opération échoue, la fonction retourne un code d’erreur système.

Remarques

N’appelez pas SetClusterGroupNodeList à 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 façon dont les handles LPC et RPC sont créés, consultez Utilisation de handles d’objet et 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

OpenClusterNode