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 |