funzione ldap_next_reference (winldap.h)

La funzione ldap_next_reference recupera un riferimento da una catena di risultati di ricerca.

Sintassi

WINLDAPAPI LDAPMessage *LDAPAPI ldap_next_reference(
  [in] LDAP        *ld,
  [in] LDAPMessage *entry
);

Parametri

[in] ld

Handle di sessione.

[in] entry

Voce restituita da una chiamata precedente a ldap_first_reference o ldap_next_reference.

Valore restituito

Se la ricerca ha restituito risultati validi, questa funzione restituisce un puntatore alla voce successiva del risultato nel set di risultati. Se non sono presenti ulteriori voci o riferimenti nel set di risultati, restituisce NULL. Si tratta dell'unico errore restituito; il parametro di errore della sessione nella struttura di dati LDAP viene cancellato su 0 in entrambi i casi.

Commenti

Usare ldap_next_reference insieme a ldap_first_reference per eseguire e recuperare un elenco di riferimenti di continuazione da una catena di risultati di ricerca.

La funzione restituisce riferimenti subordinati (riferimenti) restituiti nelle risposte di ricerca. Una segnalazione subordinata è una in cui il server ha restituito alcuni dati e la segnalazione è stata passata ad altri contesti di denominazione al di sotto del livello corrente nell'albero. Per eseguire i riferimenti esterni in cui il contesto di denominazione non risiede nel server, usare ldap_parse_result.

Non è necessario liberare in modo esplicito il riferimento restituito, poiché viene liberato quando il messaggio stesso viene liberato.

Requisiti

Vedi anche

Funzioni

ldap_first_reference

ldap_parse_result