função ldap_result (winldap.h)
A função ldap_result obtém o resultado de uma operação assíncrona.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_result(
[in] LDAP *ld,
[in] ULONG msgid,
[in] ULONG all,
[in] PLDAP_TIMEVAL timeout,
[out] PLDAPMessage *res
);
Parâmetros
[in] ld
O identificador de sessão.
[in] msgid
A ID da mensagem da operação ou a constante LDAP_RES_ANY se algum resultado for necessário.
[in] all
Especifica quantas mensagens são recuperadas em uma única chamada para ldap_result. Esse parâmetro só tem significado para os resultados da pesquisa. Passe a LDAP_MSG_ONE constante (0x00) para recuperar uma mensagem por vez. Passe LDAP_MSG_ALL (0x01) para solicitar que todos os resultados de uma pesquisa sejam recebidos antes de retornar todos os resultados em uma única cadeia. Passe LDAP_MSG_RECEIVED (0x02) para indicar que todos os resultados recuperados até agora devem ser retornados na cadeia de resultados.
[in] timeout
Um tempo limite que especifica quanto tempo, em segundos, aguardar o retorno dos resultados. Um valor NULL faz com que ldap_result sejam bloqueados até que os resultados estejam disponíveis. Um valor de tempo limite de zero segundos especifica um comportamento de sondagem.
[out] res
Contém os resultados da operação. Todos os resultados retornados devem ser liberados com uma chamada para ldap_msgfree depois que não forem mais exigidos pelo aplicativo.
Retornar valor
Se a função for bem-sucedida, ela retornará um dos valores a seguir para indicar o tipo do primeiro resultado no parâmetro res . Se o tempo limite expirar, a função retornará 0.
Se a função falhar, ela retornará –1 e definirá os parâmetros de erro de sessão na estrutura de dados LDAP.
Comentários
A função ldap_result recupera o resultado de uma operação iniciada de forma assíncrona anterior. Lembre-se de que, dependendo da forma como é chamado, ldap_result pode realmente retornar uma lista ou uma "cadeia" de mensagens.
Para LDAP sem conexão, você deve passar um identificador de conexão LDAP e uma ID de mensagem para garantir que você obtenha os resultados corretos. O tempo de execução do LDAP continua a enviar a solicitação até receber uma resposta.
Multithreading: as chamadas para ldap_result são thread-safe.
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 |