OpenClusterEx, fonction (clusapi.h)

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.

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