функция ldap_parse_page_control (winldap.h)
Ldap_parse_page_control анализирует результаты поиска на страницы.
Синтаксис
WINLDAPAPI ULONG LDAPAPI ldap_parse_page_control(
[in] PLDAP ExternalHandle,
[in] PLDAPControlA *ServerControls,
[out] ULONG *TotalCount,
[out] berval **Cookie
);
Параметры
[in] ExternalHandle
Дескриптор сеанса.
[in] ServerControls
Массив элементов управления, включающий элемент управления страницы. Элемент управления страницей содержит поля cookie и общего количества, возвращаемые сервером.
[out] TotalCount
Указатель на общее количество записей, возвращаемых на этой странице (необязательно).
[out] Cookie
Непрозрачный файл cookie, используемый сервером для определения расположения в результирующем наборе. Используйте ber_bvfree для бесплатного использования.
Возвращаемое значение
Если функция выполнена успешно, возвращаемое значение будет LDAP_SUCCESS.
Если функция завершается сбоем, она возвращает код ошибки. Дополнительные сведения см. в разделе Возвращаемые значения .
Комментарии
Используйте ldap_parse_page_control в сочетании с ldap_create_page_control и ldap_parse_result для реализации простого разбиения результатов по страницам с помощью элементов управления. После вызова ldap_parse_page_control для получения серверных элементов управления и извлечения файла cookie из результата поиска вызовите ldap_parse_result для анализа результатов. Затем используйте файл cookie для вызова ldap_create_page_control для получения следующей страницы результатов.
Требования
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | winldap.h |
| Библиотека | Wldap32.lib |
| DLL | Wldap32.dll |