fonction ldap_next_entry (winldap.h)
La fonction ldap_next_entry récupère une entrée d’une chaîne de résultats de recherche.
Syntaxe
WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_entry(
[in] LDAP *ld,
[in] LDAPMessage *entry
);
Paramètres
[in] ld
Handle de session.
[in] entry
Entrée retournée par un appel précédent à ldap_first_entry ou ldap_next_entry.
Valeur retournée
Si la recherche a retourné des résultats valides, cette fonction retourne un pointeur vers l’entrée de résultat suivante dans le jeu de résultats. S’il n’existe aucune autre entrée ou référence dans le jeu de résultats, il retourne NULL. Il s’agit du seul retour d’erreur ; le paramètre d’erreur de session dans la structure de données LDAP est effacé à 0 dans les deux cas.
Remarques
Utilisez ldap_next_entry conjointement avec ldap_first_entry pour parcourir et récupérer la liste des entrées d’une chaîne de résultats de recherche.
Vous n’êtes pas obligé de libérer explicitement l’entrée retournée, car elle est libérée lorsque le message lui-même est libéré.
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 | winldap.h |
Bibliothèque | Wldap32.lib |
DLL | Wldap32.dll |