ldap_abandon函式 (winldap.h)

用戶端 會呼叫 ldap_abandon ，以取消處理中的非同步 LDAP 呼叫。

語法

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

[in] ld

會話控制碼。

[in] msgid

要取消之呼叫的訊息識別碼。非同步函式，例如 ldap_search 和 ldap_modify，會在初始化作業時傳回此訊息識別碼。

如果函式成功，也就是說，如果取消作業成功，則傳回值為零。

如果函式失敗，傳回值為 –1。

ldap_abandon函式會先確認作業已完成。如果有，則會刪除訊息識別碼;否則，呼叫會移至伺服器以取消作業。請注意，成功呼叫 ldap_abandon 會終結訊息識別碼。因此，即使伺服器已完成作業，您也無法呼叫 ldap_result 以取得具有該訊息識別碼的結果。

沒有伺服器回應 ldap_abandon;因此，不保證呼叫已到達伺服器。

多執行緒：對 ldap_abandon 的呼叫是安全線程。