OpenCluster, fonction (clusapi.h)
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 |
|---|---|
|
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 |