Fonction ADsEnumerateNext (adshlp.h)
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 |