Partager via

OpenCluster, fonction (clusapi.h)

  • Article

Ouvre une connexion à un cluster et lui retourne un handle.

Syntaxe

HCLUSTER OpenCluster(
  [in, optional] LPCWSTR lpszClusterName
);

Paramètres

[in, optional] lpszClusterName

Spécifie l’une des valeurs suivantes :

  • Pointeur vers une chaîne Unicode terminée par un caractère Null contenant le nom du cluster ou l’un des nœuds de cluster exprimé sous la forme d’un nom NetBIOS, d’un nom DNS complet ou d’une adresse IP. Cela produit un handle de cluster RPC.
  • NULL, qui produit un handle LPC pour le cluster auquel appartient l’ordinateur local.

Valeur retournée

Si l’opération a réussi, OpenCluster retourne un handle de cluster.

Code/valeur de retour Description
NULL
0
 L’opération n’a pas réussi. Pour plus d’informations sur l’erreur, appelez la fonction GetLastError.

Remarques

Un handle de cluster est un pointeur vers une structure définie en interne qui stocke des informations sur la connexion RPC ou LPC au cluster. Tous les handles d’objet obtenus à partir du handle de cluster sont associés aux données de session RPC ou LPC stockées dans la structure du cluster. La combinaison de handles RPC et LPC ou l’utilisation de handles obtenus à partir de différents contextes peuvent entraîner des exceptions ou d’autres résultats imprévisibles. Pour plus d’informations, consultez Handles LPC et RPC.

Lorsque vous avez terminé avec un handle de cluster, il est important d’appeler CloseCluster pour vous assurer que toute la mémoire est libérée et que la connexion est arrêtée correctement.

Si le cluster est distant, le client doit exécuter un système d’exploitation compatible. Par exemple, les ordinateurs exécutant Windows Server 2008 ne peuvent pas appeler OpenCluster sur un cluster exécutant Windows Server 2016. Pour gérer ces clusters à distance, utilisez le fournisseur WMI de cluster de basculement.

Exemples

Consultez Utilisation de handles d’objet.

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

CloseCluster

Fonctions de gestion du cluster de basculement

OpenClusterEx