função ldap_first_attribute (winldap.h)
Para uma determinada entrada de diretório, a função ldap_first_attribute retorna o primeiro atributo.
Sintaxe
WINLDAPAPI PCHAR LDAPAPI ldap_first_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[out] BerElement **ptr
);
Parâmetros
[in] ld
O identificador de sessão.
[in] entry
A entrada cujos atributos devem ser passados, conforme retornado por ldap_first_entry ou ldap_next_entry.
[out] ptr
O endereço de um ponteiro usado internamente para acompanhar a posição atual na entrada.
Valor retornado
Um ponteiro para uma cadeia de caracteres terminada em nulo. Se a função for bem-sucedida, ela retornará um ponteiro para um buffer alocado que contém o nome do atributo atual. Quando não há mais atributos para percorrer, ele retorna 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 definirá o parâmetro de erro de sessão na estrutura de dados LDAP como o código de erro LDAP.
Comentários
Use ldap_first_attribute em conjunto com ldap_next_attribute para percorrer a lista de tipos de atributo retornados com uma entrada. Em seguida, você pode passar esses nomes de atributo em uma chamada para ldap_get_values para recuperar seus valores associados.
Uma chamada para ldap_first_attribute aloca e retorna por meio do parâmetro ptr , um ponteiro para uma estrutura BerElement . Passe esse ponteiro para ldap_next_attribute para acompanhar a posição atual na lista de atributos. Quando terminar de percorrer uma lista de atributos e ptr não for NULL, libere o ponteiro chamando ber_free( ptr, 0 ). Lembre-se de que você deve passar o segundo parâmetro como 0 (zero) nessa chamada.
Tanto ldap_first_attribute quanto ldap_next_attribute retornam um ponteiro para um buffer alocado que contém o nome do atributo atual. Libere esse buffer, quando não for mais necessário, chamando ldap_memfree. Como esse buffer é substituído na próxima chamada para ldap_first_attribute ou
ldap_next_attribute, o usuário deverá fazer uma cópia do nome do atributo se precisar ser preservado para processamento.
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 |