Fonction ClusterGroupOpenEnumEx (clusapi.h)

Article
02/28/2024

Ouvre un handle pour l’énumération de groupe. Le type PCLUSAPI_CLUSTER_GROUP_OPEN_ENUM_EX définit un pointeur vers cette fonction.

Syntaxe

HGROUPENUMEX ClusterGroupOpenEnumEx(
  [in] HCLUSTER hCluster,
       LPCWSTR  lpszProperties,
  [in] DWORD    cbProperties,
       LPCWSTR  lpszRoProperties,
  [in] DWORD    cbRoProperties,
  [in] DWORD    dwFlags
);

Paramètres

[in] hCluster

Handle du cluster sur lequel l’énumération sera effectuée.

lpszProperties

Pointeur vers une liste de noms de propriétés courantes.

[in] cbProperties

Taille, en octets, du champ lpszProperties .

lpszRoProperties

Pointeur vers une liste de noms de propriétés courantes en lecture seule.

[in] cbRoProperties

Taille, en octets, du champ lpszRoProperties .

[in] dwFlags

Réservé pour un usage futur. Cette valeur doit être 0.

Valeur retournée

Si l’opération réussit, la fonction retourne un handle à l’énumération.

Si l’opération échoue, la fonction retourne NULL.

Remarques

La fonction ClusterGroupOpenEnumEx se connecte au service de cluster via un appel de procédure distante (RPC) et collecte toutes les données pour gérer l’ensemble de l’énumération. Une fois l’appel RPC terminé, les données sont conservées localement. Le handle HGROUPENUMEX contient toutes les données requises pour satisfaire l’énumération. Les appels supplémentaires à ClusterGroupEnumEx ou ClusterGroupGetEnumCountEx ne se connectent pas au cluster.

Configuration requise

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

Partager via