Partager via


SetClusterNetworkPriorityOrder, fonction (clusapi.h)

[Cette fonction peut être utilisée dans les systèmes d’exploitation spécifiés dans la section Configuration requise. La prise en charge de cette méthode a été supprimée dans Windows Server 2008 et cette fonction ne fait rien et retourne ERROR_CALL_NOT_IMPLEMENTED.]

Définit l’ordre de priorité de l’ensemble de réseaux utilisés pour la communication interne entre les nœuds de cluster. Le type PCLUSAPI_SET_CLUSTER_NETWORK_PRIORITY_ORDER définit un pointeur vers cette fonction.

Syntaxe

DWORD SetClusterNetworkPriorityOrder(
  [in] HCLUSTER    hCluster,
  [in] DWORD       NetworkCount,
  [in] HNETWORK [] NetworkList
);

Paramètres

[in] hCluster

Gérez le cluster à affecter.

[in] NetworkCount

Nombre d’éléments dans la liste spécifié par le paramètre NetworkList .

[in] NetworkList

Tableau de handles hiérarchisé en objets réseau. Le premier handle du tableau a la priorité la plus élevée. La liste doit contenir uniquement les réseaux utilisés pour la communication interne entre les nœuds du cluster, et il ne peut y avoir aucun doublon.

Valeur retournée

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

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

Code/valeur de retour Description
ERROR_INVALID_PARAMETER
87 (0x57)
Il y avait un réseau en double dans NetworkList.

Remarques

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 2003 Entreprise, Windows Server 2003 Datacenter
Plateforme cible Windows
En-tête clusapi.h
Bibliothèque ClusAPI.lib
DLL ClusAPI.dll

Voir aussi

ClusterEnum

OpenCluster

OpenClusterNetwork