OpenClusterEx, fonction (clusapi.h)

Article
02/24/2024

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

Syntaxe

HCLUSTER OpenClusterEx(
  [in, optional]  LPCWSTR lpszClusterName,
  [in]            DWORD   DesiredAccess,
  [out, optional] DWORD   *GrantedAccess
);

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.

[in] DesiredAccess

Privilèges d’accès demandés. Il peut s’agir d’une combinaison de GENERIC_READ (0x80000000), de GENERIC_ALL (0x10000000) ou de MAXIMUM_ALLOWED (0x02000000). Si cette valeur est égale à zéro (0) et qu’une erreur non définie peut être retournée. L’utilisation de GENERIC_ALL revient à appeler OpenCluster.

[out, optional] GrantedAccess

Paramètre facultatif qui contient l’adresse d’un DWORD qui recevra les droits d’accès accordés. Si le paramètre DesiredAccess est MAXIMUM_ALLOWED (0x02000000), le DWORD pointé par ce paramètre contiendra les privilèges maximum accordés à cet utilisateur.

Valeur retournée

Si l’opération a réussi, OpenClusterEx 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 . Si le serveur cible ne prend pas en charge la fonction OpenClusterEx (par exemple, si le serveur cible exécute Windows Server 2008 ou une version antérieure), la fonction GetLastError retourne RPC_S_PROCNUM_OUT_OF_RANGE (1745).

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.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows Server 2008 R2 Datacenter, Windows Server 2008 R2 Entreprise
Plateforme cible	Windows
En-tête	clusapi.h
Bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Partager via