fonction ldap_next_reference (winldap.h)

La fonction ldap_next_reference récupère une référence à partir d’une chaîne de résultats de recherche.

Syntaxe

WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
  [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_reference ou ldap_next_reference.

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_reference conjointement avec ldap_first_reference pour parcourir et récupérer une liste de références de continuation à partir d’une chaîne de résultats de recherche.

La fonction retourne les références subordonnées (références) qui sont retournées dans les réponses de recherche. Une référence subordonnée est une référence dans laquelle le serveur a retourné certaines données et la référence a été passée à d’autres contextes de nommage en dessous du niveau actuel dans l’arborescence. Pour parcourir pas à pas les références externes dans lesquelles le contexte de nommage ne réside pas sur le serveur, utilisez ldap_parse_result.

Vous n’êtes pas obligé de libérer explicitement la référence retournée, car elle est libérée lorsque le message lui-même est libéré.

Configuration requise

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

Voir aussi

Fonctions

ldap_first_reference

ldap_parse_result