ldap_first_entry, fonction (winldap.h)
La fonction ldap_first_entry retourne la première entrée d’un message.
Syntaxe
WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_entry(
[in] LDAP *ld,
[in] LDAPMessage *res
);
Paramètres
[in] ld
Handle de session.
[in] res
Résultat de la recherche, tel qu’obtenu par un appel à l’une des routines de recherche synchrone ou ldap_result.
Valeur retournée
Si la recherche a retourné des résultats valides, cette fonction retourne un pointeur vers la première entrée de résultat. S’il n’existe aucune entrée ou référence dans le jeu de résultats, elle 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_first_entry conjointement avec ldap_next_entry pour parcourir et récupérer la liste des entrées d’une chaîne de résultats de recherche.
Vous n’avez pas besoin 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 |