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 |