ClusterGroupOpenEnum, fonction (clusapi.h)

Ouvre un énumérateur pour effectuer une itération via les ressourcesd’un groupe de et/ou les nœuds inclus dans sa liste de propriétaires préférés. Le type PCLUSAPI_CLUSTER_GROUP_OPEN_ENUM définit un pointeur vers cette fonction.

Syntaxe

HGROUPENUM ClusterGroupOpenEnum(
  [in] HGROUP hGroup,
  [in] DWORD  dwType
);

Paramètres

[in] hGroup

Handle du groupe à énumérer.

[in] dwType

Masque de bits qui décrit les objets de cluster à énumérer. Voici les valeurs valides de l’énumération CLUSTER_GROUP_ENUM.

CLUSTER_GROUP_ENUM_CONTAINS (1)

Énumère les ressources du groupe.

CLUSTER_GROUP_ENUM_NODES (2)

Énumère les nœuds dans la liste des propriétaires préférés du groupe.

CLUSTER_GROUP_ENUM_ALL (3)

Énumère les ressources du groupe et les propriétaires préférés du groupe.

Valeur de retour

Si l’opération réussit, ClusterGroupOpenEnum retourne un handle à un énumérateur qui peut être passé à la fonction ClusterGroupEnum.

Si l’opération échoue, la fonction retourne NULL. Pour plus d’informations sur l’erreur, appelez la fonction GetLastError.

Remarques

N’appelez pas ClusterGroupOpenEnum à partir d’une fonction de point d’entrée DLL de ressource. ClusterGroupOpenEnum peut être appelé en toute sécurité à partir d’un thread de travail. Pour plus d’informations, consultez appels de fonction à éviter dans les DLL de ressources.

Exemples

Consultez énumération d’objets.

Exigences

Exigence	Valeur
client minimum pris en charge	Aucun pris en charge
serveur minimum pris en charge	Windows Server 2008 Enterprise, Windows Server 2008 Datacenter
plateforme cible	Windows
d’en-tête	clusapi.h
bibliothèque	ClusAPI.lib
DLL	ClusAPI.dll

Voir aussi

ClusterGroupCloseEnum

clusterGroupEnum

fonctions de gestion de groupe

OpenClusterGroup