Fonction ADsEnumerateNext (adshlp.h)

Article
02/26/2024

La fonction ADsEnumerateNext énumère un nombre spécifié d’éléments à partir de la position actuelle du curseur de l’énumérateur. Lorsque l’opération réussit, la fonction retourne le jeu d’éléments énuméré dans un tableau de variantes. Le nombre d’éléments retournés peut être inférieur au nombre spécifié.

Syntaxe

HRESULT ADsEnumerateNext(
  [in]  IEnumVARIANT *pEnumVariant,
  [in]  ULONG        cElements,
  [out] VARIANT      *pvar,
  [out] ULONG        *pcElementsFetched
);

Paramètres

[in] pEnumVariant

Type : IEnumVARIANT*

Pointeur vers l’interface IEnumVARIANT sur l’objet énumérateur.

[in] cElements

Type : ULONG

Nombre d’éléments demandés.

[out] pvar

Type : VARIANT*

Pointeur vers le tableau d’éléments récupérés.

[out] pcElementsFetched

Type : ULONG*

Nombre réel d’éléments récupérés, qui peut être inférieur au nombre d’éléments demandés.

Valeur retournée

Type : HRESULT

Cette méthode prend en charge les valeurs de retour standard.

Pour plus d’informations sur les autres valeurs de retour, consultez Codes d’erreur ADSI.

Remarques

Le processus général d’énumération des objets dans un conteneur implique les éléments suivants :

Tout d’abord, créez un objet énumérateur sur ce conteneur.

Ensuite, récupérez le pointeur d’interface IEnumVARIANT .

Troisièmement, appelez la fonction ADsEnumerateNext pour retourner un ensemble énuméré d’éléments à partir de l’objet énumérateur.

Quatrièmement, appelez la fonction ADSFreeEnumerator pour libérer l’objet énumérateur.

Pour plus d’informations et un exemple de code, consultez la rubrique ADsBuildEnumerator .

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista
Serveur minimal pris en charge	Windows Server 2008
Plateforme cible	Windows
En-tête	adshlp.h
Bibliothèque	Activeds.lib
DLL	Activeds.dll