função ldap_abandon (winldap.h)
Um cliente chama ldap_abandon para cancelar uma chamada LDAP assíncrona em processo.
Sintaxe
WINLDAPAPI ULONG LDAPAPI ldap_abandon(
[in] LDAP *ld,
[in] ULONG msgid
);
Parâmetros
[in] ld
O identificador da sessão.
[in] msgid
A ID da mensagem da chamada a ser cancelada. Funções assíncronas, como ldap_search e ldap_modify, retornam essa ID de mensagem quando iniciam uma operação.
Valor retornado
Se a função for bem-sucedida, ou seja, se a operação de cancelamento for bem-sucedida, o valor retornado será zero.
Se a função falhar, o valor retornado será –1.
Comentários
A função ldap_abandon primeiro verifica se a operação foi concluída. Se tiver, a ID da mensagem será excluída; caso contrário, a chamada vai para o servidor para cancelar a operação. Lembre-se de que uma chamada bem-sucedida para ldap_abandon destrói a ID da mensagem. Portanto, você não pode chamar ldap_result para obter resultados com essa ID de mensagem, mesmo que o servidor tenha concluído a operação.
Não há resposta do servidor para ldap_abandon; portanto, não há nenhuma garantia de que a chamada chegou ao servidor.
Multithreading: as chamadas para ldap_abandon são thread-safe.
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 |