funzione ldap_first_reference (winldap.h)

La funzione ldap_first_reference restituisce il primo riferimento da un messaggio.

Sintassi

WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_reference(
  [in] LDAP        *ld,
  [in] LDAPMessage *res
);

Parametri

[in] ld

Handle di sessione.

[in] res

Risultato della ricerca, ottenuto da una chiamata a una delle routine di ricerca sincrone o ldap_result.

Valore restituito

Se la ricerca ha restituito risultati validi, questa funzione restituisce un puntatore al primo riferimento al risultato. Se nel set di risultati non esiste alcuna voce o riferimento, 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_first_reference insieme a ldap_next_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 invece.

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

Requisiti

Vedi anche

Funzioni

ldap_next_reference

ldap_parse_result

ldap_result