funzione ldap_get_values_len (winldap.h)

La funzione ldap_get_values_len recupera l'elenco di valori per un determinato attributo.

Sintassi

WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
  [in] LDAP        *ExternalHandle,
  [in] LDAPMessage *Message,
  [in] const PSTR  attr
);

Parametri

[in] ExternalHandle

Handle di sessione.

[in] Message

Handle per la struttura LDAPMessage .

[in] attr

Puntatore a una stringa con terminazione Null che contiene l'attributo i cui valori devono essere recuperati.

Valore restituito

Se la funzione ha esito positivo, restituisce un elenco di puntatori con terminazione Null alle strutture berval che contengono i valori dell'attributo specificato. Se non sono stati trovati valori di attributo, restituisce NULL. Il parametro di errore della sessione nella struttura dei dati LDAP è impostato su 0 in entrambi i casi.

Se la funzione non riesce, restituisce NULL e il parametro di errore della sessione nella struttura dei dati LDAP viene impostato sul codice di errore LDAP.

Commenti

Usare ldap_get_values_len durante l'analisi di una risposta di ricerca per ottenere il valore o i valori di un attributo. Usare questa funzione quando l'attributo contiene dati binari; per gli attributi i cui valori sono stringhe di caratteri con terminazione Null, usare ldap_get_values.

La voce viene ottenuta chiamando ldap_first_entry o ldap_next_entry. L'attributo deve essere restituito da una chiamata a ldap_first_attribute, ldap_next_attribute o una stringa fornita dal chiamante ,ad esempio "mail".

Chiamare ldap_value_free_len per rilasciare il valore restituito quando non è più necessario.

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

Funzioni

LDAPMessage

berval

ldap_first_attribute

ldap_first_entry

ldap_get_values

ldap_next_attribute

ldap_next_entry

ldap_value_free_len