ldap_get_next_page函式 (winldap.h)
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 |