função ldap_get_values (winldap.h)
A função ldap_get_values recupera a lista de valores de um determinado atributo.
Sintaxe
WINLDAPAPI PCHAR *LDAPAPI ldap_get_values(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in] const PSTR attr
);
Parâmetros
[in] ld
O identificador da sessão.
[in] entry
A entrada da qual recuperar valores.
[in] attr
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o atributo cujos valores devem ser recuperados.
Valor retornado
Se a função for bem-sucedida, ela retornará uma lista terminada em nulo de ponteiros para valores. Se nenhum valor de atributo tiver sido encontrado, ele geralmente retornará NULL. Mas, em alguns casos, pode retornar uma lista de um ponteiro que é NULL. Sempre use ldap_count_values para obter a contagem de valores na lista retornada, conforme observado em Comentários. O parâmetro de erro de sessão na estrutura de dados LDAP é definido como 0 em ambos os casos.
Se a função falhar, ela retornará NULL e o parâmetro de erro de sessão na estrutura de dados LDAP será definido como o código de erro LDAP.
Comentários
Use ldap_get_values ao analisar uma resposta de pesquisa para obter o valor ou os valores de um atributo. Use essa função somente quando o atributo contiver cadeias de caracteres terminadas em nulo; para dados binários, use ldap_get_values_len em vez disso.
A entrada é obtida chamando ldap_first_entry ou ldap_next_entry. O atributo deve ser um retornado por uma chamada para ldap_first_attribute, ldap_next_attribute ou uma cadeia de caracteres fornecida pelo chamador (por exemplo, "email").
Use ldap_count_values para obter a contagem de valores na lista retornada. Chame ldap_value_free para liberar o valor retornado quando ele não for mais necessário.
Determinados servidores LDAP colocam limites no número de valores de cadeia de caracteres de atributo retornados em uma única chamada. Para obter mais informações sobre como usar especificadores de recuperação de intervalo, consulte Pesquisando usando a recuperação de intervalo.
Requisitos
| Cliente mínimo com suporte | Windows Vista |
| Servidor mínimo com suporte | Windows Server 2008 |
| Plataforma de Destino | Windows |
| Cabeçalho | winldap.h |
| Biblioteca | Wldap32.lib |
| DLL | Wldap32.dll |