ldap_get_next_page函式 (winldap.h)

發行項
03/13/2024

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

語法

WINLDAPAPI ULONG LDAPAPI ldap_get_next_page(
  [in]  PLDAP       ExternalHandle,
  [in]  PLDAPSearch SearchHandle,
  [in]  ULONG       PageSize,
  [out] ULONG       *MessageNumber
);

參數

[in] ExternalHandle

會話句柄。

[in] SearchHandle

搜尋區塊句柄。

[in] PageSize

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

[out] MessageNumber

要求的訊息識別碼。

傳回值

如果函式成功，傳回值 會LDAP_SUCCESS。

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

備註

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

請注意，在每次呼叫 ldap_get_next_page之後，您必須針對使用 ldap_result 從伺服器傳回的每個結果集呼叫 ldap_get_paged_count。這可讓LDAP運行時間儲存伺服器傳回以維護搜尋狀態的Cookie。除了呼叫 ldap_get_paged_count以外，從 ldap_get_next_page 傳回的結果可以當作任何其他搜尋結果來處理，而且必須在完成時透過呼叫 ldap_msgfree 來釋放。

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

如果您想要同步擷取分頁搜尋結果，請使用 ldap_get_next_page_s。

規格需求

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