funzione ldap_get_values (winldap.h)

La funzione ldap_get_values recupera l'elenco di valori di un attributo specificato.

Sintassi

WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
  [in] LDAP        *ld,
  [in] LDAPMessage *entry,
  [in] const PSTR  attr
);

Parametri

[in] ld

Handle di sessione.

[in] entry

Voce da cui recuperare i valori.

[in] attr

Puntatore a una stringa con terminazione null contenente l'attributo i cui valori devono essere recuperati.

Valore restituito

Se la funzione ha esito positivo, restituisce un elenco con terminazione null dei puntatori ai valori. Se non sono stati trovati valori di attributo, in genere restituisce NULL. Tuttavia, in alcuni casi può restituire un puntatore di elenco null. Assicurarsi sempre di usare ldap_count_values per ottenere il conteggio dei valori nell'elenco restituito, come indicato in Osservazioni. Il parametro di errore della sessione nella struttura di dati LDAP è impostato su 0 in entrambi i casi.

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

Commenti

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

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").

Usare ldap_count_values per ottenere il conteggio dei valori nell'elenco restituito. Chiamare ldap_value_free per rilasciare il valore restituito quando non è più necessario.

Alcuni server LDAP pongono limiti al numero di valori di stringa di attributo restituiti in una singola chiamata. Per altre informazioni sull'uso di identificatori di recupero intervallo, vedere Ricerca con recupero intervallo.

Requisiti

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

Ricerca di una directory

ldap_first_attribute

ldap_first_entry

ldap_get_values_len

ldap_next_attribute

ldap_next_entry

ldap_value_free