ldap_get_next_page_s (Windows CE 5.0)
This function returns the next page in a sequence of synchronous paged search results.
ULONG ldap_get_next_page_s(LDAP*ExternalHandle,LDAPSearch*SearchHandle,LDAP_TIMEVAL* timeout,ULONGPageSize,ULONG* TotalCount,LDAPMessage** Results);
Parameters
- ExternalHandle
[in] Session handle. - SearchHandle
[in] Handle to the search block. - timeout
[in] Length of time in seconds the client is willing to wait for the call to return. - PageSize
[in] Number of entries to return in a single page. - TotalCount
[out] Server's estimate of the total number of entries in the entire result set. A value of zero means that the server could not provide an estimate. - Results
[out] Pointer to the LDAPMessage structure that contains the results of the operation.
Return Values
If the server returns a null cookie (noncontinuation), the value will be LDAP_NO_RESULTS_RETURNED. Otherwise, the client signals a continuation (more data available) by returning LDAP_SUCCESS.
If the function otherwise fails, it returns the error code pertinent to the failure. See the LDAP_RETCODE enumeration for a list of possible return values.
Remarks
This function is part of the interface for simple, synchronous paging of search results. Use the search handle returned from an initial call to ldap_search_init_page and specify, in the PageSize parameter, the number of entries to be returned in a page. Set PageSize to 0 (zero) to abandon a search.
The results you get back from ldap_get_next_page_s can be treated as any other search result and should be freed when you are done by calling the ldap_msgfree function.
If you prefer to retrieve paged search result asynchronously, use ldap_get_next_page.
Using ldap_get_next_page_s eliminates the need to call ldap_get_paged_count to record the number of paged results returned by a server.
Requirements
OS Versions: Windows CE .NET 4.0 and later.
Header: Winldap.h.
Link Library: Wldap32.lib.
See Also
LDAP_RETCODE | ldap_get_next_page | ldap_get_paged_count | LDAPMessage | ldap_msgfree | ldap_search_init_page
Send Feedback on this topic to the authors