função ldap_next_attribute (winldap.h)
Para uma determinada entrada, a função ldap_next_attribute retorna o próximo atributo.
Sintaxe
WINLDAPAPI PCHAR LDAPAPI ldap_next_attribute(
[in] LDAP *ld,
[in] LDAPMessage *entry,
[in, 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.
[in, out] ptr
O endereço de um ponteiro usado internamente para acompanhar a posição atual na entrada.
Retornar valor
Se a função for bem-sucedida, ela retornará um ponteiro para uma cadeia de caracteres terminada em nulo que contém o nome do atributo atual. Se não houver mais atributos para percorrer, 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 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_next_attribute em conjunto com ldap_first_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_next_attribute retorna, por meio do parâmetro ptr , um ponteiro para uma estrutura BerElement . Passe esse ponteiro para a próxima chamada 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.
A função ldap_next_attribute retorna um ponteiro para um buffer alocado internamente 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 deve fazer uma cópia do nome do atributo se precisar ser preservado para processamento.
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 |