функция 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_get_paged_count для каждого набора результатов, возвращаемых с сервера с помощью ldap_result. Это позволяет во время выполнения 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 |
| Header | winldap.h |
| Библиотека | Wldap32.lib |
| DLL | Wldap32.dll |