Fonction MgmGroupEnumerationGetNext (mgm.h)

Article
08/24/2023

La fonction MgmGroupEnumerationGetNext récupère le jeu d’entrées de groupe suivant. Les informations retournées par cette fonction sont une liste de groupes joints et les sources demandées, le cas échéant.

Les groupes ne sont pas retournés dans un ordre particulier.

Syntaxe

DWORD MgmGroupEnumerationGetNext(
  [in]      HANDLE hEnum,
  [in, out] PDWORD pdwBufferSize,
  [in, out] PBYTE  pbBuffer,
  [in, out] PDWORD pdwNumEntries
);

Paramètres

[in] hEnum

Gérez l’énumération obtenue à partir d’un appel précédent à MgmGroupEnumerationStart.

[in, out] pdwBufferSize

Lors de l’entrée, pdwBufferSize est un pointeur vers un emplacement de mémoire de taille DWORD qui contient la taille, en octets, de la mémoire tampon pointée par pbBuffer.

Lors de la sortie, si la valeur de retour est ERROR_INSUFFICIENT_BUFFER, pdwBufferSize reçoit la taille minimale que la mémoire tampon pointée par pbBuffer doit être pour contenir une entrée de groupe ; sinon, la valeur de pdwBufferSize reste inchangée.

[in, out] pbBuffer

Lors de l’entrée, le client doit fournir un pointeur vers une mémoire tampon.

Sur la sortie, pbBuffer contient une ou plusieurs entrées de groupe. Chaque entrée de groupe est une structure SOURCE_GROUP_ENTRY .

[in, out] pdwNumEntries

Lors de l’entrée, le client doit fournir un pointeur vers une valeur DWORD .

Lors de la sortie, pdwNumEntries reçoit le nombre de groupes dans pbBuffer.

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_INSUFFICIENT_BUFFER	La mémoire tampon spécifiée est trop petite pour contenir un seul groupe. Le client doit case activée la valeur de pdwBufferSize pour la taille de mémoire tampon minimale requise pour récupérer un groupe.
ERROR_INVALID_PARAMETER	Handle non valide pour une énumération.
ERROR_MORE_DATA	D’autres groupes sont disponibles.
ERROR_NO_MORE_ITEMS	Plus aucun groupe n’est disponible. Zéro ou plusieurs groupes ont été retournés ; case activée la valeur de pdwNumEntries pour vérifier le nombre de groupes retournés.
ERROR_NOT_ENOUGH_MEMORY	Mémoire insuffisante pour effectuer cette opération.

Spécifications


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

MgmGroupEnumerationEnd

MgmGroupEnumerationStart

SOURCE_GROUP_ENTRY

Partager via