Função ldap_get_values_len (winldap.h)
A função ldap_get_values_len recupera a lista de valores de um determinado atributo.
Sintaxe
WINLDAPAPI berval **LDAPAPI ldap_get_values_len(
[in] LDAP *ExternalHandle,
[in] LDAPMessage *Message,
[in] const PSTR attr
);
Parâmetros
[in] ExternalHandle
O identificador da sessão.
[in] Message
Manipule para a estrutura LDAPMessage .
[in] attr
Um ponteiro para uma cadeia de caracteres terminada em nulo que contém o atributo cujos valores devem ser recuperados.
Retornar valor
Se a função for bem-sucedida, ela retornará uma lista terminada em nulo de ponteiros para estruturas berval que contêm os valores do atributo especificado. Se nenhum valor de atributo tiver sido encontrado, ele retornará NULL. 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_len ao analisar uma resposta de pesquisa para obter o valor ou os valores de um atributo. Use essa função quando o atributo contiver dados binários; para atributos cujos valores são cadeias de caracteres terminadas em nulo, use ldap_get_values.
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").
Chame ldap_value_free_len para liberar o valor retornado quando ele não for mais necessário.
Requisitos
| Requisito | Valor |
|---|---|
| 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 |