ldap_get_next_page_s 函式 (winldap.h)

發行項
03/13/2024

ldap_get_next_page_s函式會傳回同步分頁搜尋結果序列中的下一頁。

語法

WINLDAPAPI ULONG LDAPAPI ldap_get_next_page_s(
  [in]  PLDAP       ExternalHandle,
  [in]  PLDAPSearch SearchHandle,
  [in]  l_timeval   *timeout,
  [in]  ULONG       PageSize,
  [out] ULONG       *TotalCount,
  [out] LDAPMessage **Results
);

參數

[in] ExternalHandle

會話句柄。

[in] SearchHandle

搜尋區塊句柄。

[in] timeout

用戶端會等候呼叫傳回的時間值，以秒為單位。

[in] PageSize

單一頁面中要傳回的項目數。

[out] TotalCount

整個結果集中專案總數的伺服器估計值。值為零表示伺服器無法提供估計值。

[out] Results

包含結果之 LDAPMessage 結構的指標。

傳回值

如果伺服器傳回 null Cookie (非接續) ，則會 LDAP_NO_RESULTS_RETURNED值。否則，客戶端會傳回LDAP_SUCCESS，以發出接續 (更多可用數據 ) 訊號。

如果函式否則會失敗，它會傳回與失敗相關的錯誤碼傳回值。如需詳細資訊，請參閱傳回值。

備註

ldap_get_next_page_s函式是簡單、同步搜尋結果分頁介面的一部分。使用從初始呼叫傳回的搜尋句柄來ldap_search_init_page ，並在 PageSize 參數中指定要傳回的頁面項目數目。將 PageSize 設定為零以結束搜尋。

從 ldap_get_next_page_s 傳回的結果可以當作任何其他搜尋結果來處理，而且應該在完成時釋放，方法是呼叫 ldap_msgfree。

剖析結果集時，伺服器可能會傳回空的結果頁面，但仍會以 LDAP_SUCCESS 傳回碼回應。這表示伺服器因逾時或其他原因而無法擷取結果頁面，但尚未完成搜尋要求。此實例中的適當行為是繼續呼叫 ldap_get_next_page_s ，直到成功擷取結果的另一頁、傳回錯誤碼，或 傳回LDAP_NO_RESULTS_RETURNED 以指出搜尋已完成為止。

若要以異步方式擷取分頁搜尋結果，請使用 ldap_get_next_page。

如果使用 ldap_get_next_page_s ，則不需要呼叫 ldap_get_paged_count 來記錄伺服器傳回的分頁結果數目。

規格需求

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