ldap_result函式 (winldap.h)

ldap_result函式會取得異步操作的結果。

語法

WINLDAPAPI ULONG LDAPAPI ldap_result(
  [in]  LDAP          *ld,
  [in]  ULONG         msgid,
  [in]  ULONG         all,
  [in]  PLDAP_TIMEVAL timeout,
  [out] PLDAPMessage  *res
);

參數

[in] ld

會話句柄。

[in] msgid

作業的訊息標識碼，或如果需要任何結果，則為常數LDAP_RES_ANY。

[in] all

指定在單一呼叫中擷取ldap_result的訊息數目。 此參數只有搜尋結果的意義。 傳遞常數LDAP_MSG_ONE (0x00) 一次撷取一则讯息。 傳遞LDAP_MSG_ALL (0x01) ，要求在傳回單一鏈結中的所有結果之前，先收到搜尋的所有結果。 傳遞LDAP_MSG_RECEIVED (0x02) ，表示到目前為止擷取的所有結果都應該在結果鏈結中傳回。

[in] timeout

指定等候傳回結果的逾時，以秒為單位。 NULL 值會導致ldap_result封鎖，直到結果可用為止。 零秒的逾時值會指定輪詢行為。

[out] res

包含作業 () 的結果。 一旦應用程式不再需要傳回任何結果，就應該透過呼叫 來釋放ldap_msgfree 。

傳回值

如果函式成功，它會傳回下列其中一個值，以指出 res 參數中第一個結果的類型。 如果逾時到期，函式會傳回 0。

如果函式失敗，它會傳回 –1，並在LDAP數據結構中設定會話錯誤參數。

備註

ldap_result函式會擷取先前異步起始作業的結果。 請注意，根據呼叫的方式， ldap_result 實際上可能會傳回訊息的清單或「鏈結」。

對於無連線 LDAP，您必須同時傳遞 LDAP 連線句柄和訊息識別碼，以確保您取得正確的結果。 LDAP 運行時間會繼續傳送要求，直到收到響應為止。

多線程： 對ldap_result 的呼叫是安全線程。

規格需求

需求	值
最低支援的用戶端	Windows Vista
最低支援的伺服器	Windows Server 2008
目標平台	Windows
標頭	winldap.h
程式庫	Wldap32.lib
Dll	Wldap32.dll

請參閱

函式

ldap_msgfree