função ldap_first_entry (winldap.h)

A função ldap_first_entry retorna a primeira entrada de uma mensagem.

Sintaxe

WINLDAPAPI LDAPMessage *LDAPAPI ldap_first_entry(
  [in] LDAP        *ld,
  [in] LDAPMessage *res
);

Parâmetros

[in] ld

O identificador de sessão.

[in] res

O resultado da pesquisa, conforme obtido por uma chamada para uma das rotinas de pesquisa síncronas ou ldap_result.

Retornar valor

Se a pesquisa retornar resultados válidos, essa função retornará um ponteiro para a primeira entrada de resultado. Se nenhuma entrada ou referência existir no conjunto de resultados, ela retornará NULL. Esse é o único retorno de erro; o parâmetro de erro de sessão na estrutura de dados LDAP é limpo para 0 em ambos os casos.

Comentários

Use ldap_first_entry em conjunto com ldap_next_entry para percorrer e recuperar a lista de entradas de uma cadeia de resultados de pesquisa.

Você não precisa liberar explicitamente a entrada retornada, pois ela é liberada quando a própria mensagem é liberada.

Requisitos

Confira também

Funções

ldap_next_entry

Ldap_result