Fonction OpenClusterGroupEx (clusapi.h)

Article
02/24/2024

Ouvre un groupe de cluster de basculement et lui retourne un handle.

Syntaxe

HGROUP OpenClusterGroupEx(
  [in]            HCLUSTER hCluster,
  [in, optional]  LPCWSTR  lpszGroupName,
  [in]            DWORD    dwDesiredAccess,
  [out, optional] DWORD    *lpdwGrantedAccess
);

Paramètres

[in] hCluster

Gérez vers un cluster qui inclut le groupe à ouvrir.

[in, optional] lpszGroupName

Nom du groupe à ouvrir.

[in] dwDesiredAccess

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. Utiliser GENERIC_ALL revient à appeler OpenClusterGroup.

[out, optional] lpdwGrantedAccess

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 le nombre maximal de privilèges accordés à cet utilisateur.

Valeur retournée

Si l’opération a réussi, OpenClusterGroupEx retourne un handle de groupe.

Code de retour	Description
NULL	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 OpenClusterGroupEx (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).

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

Voir aussi

CloseClusterGroup

Fonctions d’administration de groupe

OpenClusterGroup

Partager via