funzione ldap_next_attribute (winldap.h)

Per una determinata voce, la funzione ldap_next_attribute restituisce l'attributo successivo.

Sintassi

WINLDAPAPI PCHAR LDAPAPI ldap_next_attribute(
  [in]      LDAP        *ld,
  [in]      LDAPMessage *entry,
  [in, out] BerElement  *ptr
);

Parametri

[in] ld

Handle di sessione.

[in] entry

Voce i cui attributi devono essere sottoposti a rientri, come restituito da ldap_first_entry o ldap_next_entry.

[in, out] ptr

Indirizzo di un puntatore utilizzato internamente per tenere traccia della posizione corrente nella voce.

Valore restituito

Se la funzione ha esito positivo, restituisce un puntatore a una stringa con terminazione Null contenente il nome dell'attributo corrente. Se non sono presenti altri attributi da eseguire, restituisce NULL. Il parametro di errore della sessione nella struttura dei dati LDAP è impostato su 0 in entrambi i casi.

Se la funzione ha esito negativo, restituisce NULL e imposta il parametro di errore della sessione nella struttura dei dati LDAP sul codice di errore LDAP.

Commenti

Usare ldap_next_attribute in combinazione con ldap_first_attribute per esaminare l'elenco dei tipi di attributo restituiti con una voce. È quindi possibile passare questi nomi di attributo in una chiamata a ldap_get_values per recuperare i valori associati.

Una chiamata a ldap_next_attribute restituisce, tramite il parametro ptr , un puntatore a una struttura BerElement . Passare questo puntatore alla chiamata successiva a ldap_next_attribute per tenere traccia della posizione corrente nell'elenco di attributi. Dopo aver completato l'esecuzione di un elenco di attributi e ptr è diverso da NULL, liberare il puntatore chiamando ber_free (ptr, 0). Tenere presente che è necessario passare il secondo parametro come 0 (zero) in questa chiamata.

La funzione ldap_next_attribute restituisce un puntatore a un buffer allocato internamente contenente il nome dell'attributo corrente. Liberare questo buffer, quando non è più necessario, chiamando ldap_memfree. Poiché questo buffer viene sovrascritto nella chiamata successiva a ldap_first_attribute o ldap_next_attribute, l'utente deve creare una copia del nome dell'attributo se deve essere mantenuto per l'elaborazione.

Requisiti

Requisito	Valore
Client minimo supportato	Windows Vista
Server minimo supportato	Windows Server 2008
Piattaforma di destinazione	Windows
Intestazione	winldap.h
Libreria	Wldap32.lib
DLL	Wldap32.dll

Vedi anche

BerElement

Funzioni

Ricerca in una directory

ber_free

ldap_first_attribute

ldap_first_entry

ldap_get_values

ldap_memfree

ldap_next_entry