ldap_abandon 函数 (winldap.h)

客户端调用 ldap_abandon 来取消进程内异步 LDAP 调用。

语法

WINLDAPAPI ULONG LDAPAPI ldap_abandon(
  [in] LDAP  *ld,
  [in] ULONG msgid
);

[in] ld

会话句柄。

[in] msgid

要取消的调用的消息 ID。异步函数（如 ldap_search 和 ldap_modify）在启动操作时返回此消息 ID。

如果函数成功，即如果取消操作成功，则返回值为零。

如果函数失败，则返回值为 –1。

ldap_abandon 函数首先验证操作是否已完成。如果有，则删除消息 ID;否则，调用将转到服务器以取消操作。请注意，成功调用 ldap_abandon 会销毁消息 ID。因此，即使服务器完成了操作，也不能调用 ldap_result 来获取具有该消息 ID 的结果。

没有服务器响应 ldap_abandon;因此，不能保证调用到达服务器。

多线程处理：对 ldap_abandon 的调用是线程安全的。