Fonction MgmGroupEnumerationStart (mgm.h)

Article
02/29/2024

La fonction MgmGroupEnumerationStart obtient un handle d’énumération qui sera utilisé plus tard pour obtenir la liste des groupes qui ont été joints. Une fois que le client a obtenu le handle, il doit utiliser la fonction MgmGroupEnumerationGetNext pour énumérer les groupes.

Syntaxe

DWORD MgmGroupEnumerationStart(
  [in]  HANDLE         hProtocol,
  [in]  MGM_ENUM_TYPES metEnumType,
  [out] HANDLE         *phEnumHandle
);

Paramètres

[in] hProtocol

Gérez le protocole obtenu à partir d’un appel précédent à MgmRegisterMProtocol.

[in] metEnumType

Spécifie le type d’énumération. Les énumérations suivantes sont disponibles.

Énumération	Signification
ALL_SOURCES	Récupère les jointures génériques (*, g) et les jointures spécifiques à la source (s, g).
ANY_SOURCE	Récupère les entrées de groupe qui ont au moins une source spécifiée.

[out] phEnumHandle

Reçoit le handle de l’énumération. Utilisez ce handle dans les appels à MgmGroupEnumerationGetNext et MgmGroupEnumerationEnd.

Valeur retournée

Si la fonction réussit, la valeur de retour est NO_ERROR.

Si la fonction échoue, la valeur de retour est l’un des codes d’erreur suivants.

Valeur	Signification
ERROR_CAN_NOT_COMPLETE	Impossible de terminer l’appel à cette fonction.
ERROR_INVALID_PARAMETER	Handle non valide pour un protocole.
ERROR_NOT_ENOUGH_MEMORY	Mémoire insuffisante pour effectuer cette opération.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Aucun pris en charge
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	mgm.h
Bibliothèque	Rtm.lib
DLL	Rtm.dll

Voir aussi

MGM_ENUM_TYPES

MgmGroupEnumerationEnd

MgmGroupEnumerationGetNext

Partager via