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