функция ldap_search_init_page (winldap.h)

Статья
08/27/2023

Функция ldap_search_init_page инициализирует блок поиска для простого поиска по страницам. Эта функция поддерживается в LDAP 3.

Синтаксис

WINLDAPAPI PLDAPSearch LDAPAPI ldap_search_init_page(
  [in] PLDAP        ExternalHandle,
  [in] const PSTR   DistinguishedName,
  [in] ULONG        ScopeOfSearch,
  [in] const PSTR   SearchFilter,
  [in] PZPSTR       AttributeList,
  [in] ULONG        AttributesOnly,
  [in] PLDAPControl *ServerControls,
  [in] PLDAPControl *ClientControls,
  [in] ULONG        PageTimeLimit,
  [in] ULONG        TotalSizeLimit,
  [in] PLDAPSortKey *SortKeys
);

Параметры

[in] ExternalHandle

Дескриптор сеанса.

[in] DistinguishedName

Указатель на строку, завершающуюся null, которая содержит различающееся имя записи, с которой начинается поиск.

[in] ScopeOfSearch

Тип данных, указывающий одно из следующих значений для указания область поиска.

LDAP_SCOPE_BASE

Поиск только в базовой записи.

LDAP_SCOPE_ONELEVEL

Выполните поиск всех записей на первом уровне под базовой записью, за исключением базовой записи.

LDAP_SCOPE_SUBTREE

Выполните поиск базовой записи и всех записей в дереве под основанием.

[in] SearchFilter

Указатель на строку, завершающуюся значением NULL, которая указывает фильтр поиска. Дополнительные сведения см. в разделе Синтаксис фильтра поиска.

[in] AttributeList

Массив строк, завершаемых значением NULL, указывающий, какие атрибуты следует возвращать для каждой совпадающей записи. Передайте значение NULL , чтобы получить все доступные атрибуты.

[in] AttributesOnly

Логическое значение, которое должно быть равно нулю, если должны быть возвращены как типы атрибутов, так и значения, ненулевое, если должны быть возвращены только типы.

[in] ServerControls

Список серверных элементов управления LDAP.

[in] ClientControls

Список клиентских элементов управления.

[in] PageTimeLimit

Значение времени (в секундах), которое клиент будет ожидать, пока сервер вернет страницу.

[in] TotalSizeLimit

Максимальное количество записей, которые будет принимать клиент. Значение TotalSizeLimit влияет только на отдельные страницы страничного поиска (но не на общий поиск по страницам). Таким образом, если TotalSizeLimit больше размера страницы, то TotalSizeLimit не будет иметь никакого эффекта.

[in] SortKeys

Указатель на структуру LDAPSortKey , которая указывает тип атрибута, правило упорядочения и направление поиска.

Возвращаемое значение

Если функция выполняется успешно, она возвращает указатель на структуру LDAPSearch .

Если функция завершается сбоем, возвращается значение NULL. Чтобы получить код ошибки, используйте LdapGetLastError или GetLastError .

Вызовите ldap_search_abandon_page , чтобы освободить возвращаемую структуру.

Функция ldap_search_init_page создает структуру LDAPSearch для управления страничными поисками и возвращает дескриптор в структуру. Функции ldap_get_next_page, ldap_get_next_page_s и ldap_get_paged_count требуют этого дескриптора поиска в качестве параметра. После завершения поиска по страницам вызовите ldap_search_abandon_page , чтобы освободить эту структуру и ее дескриптор.

Чтобы определить, поддерживает ли сервер поиск по страницам, проверка свойство supportedControl вне корневого каталога для идентификатора объекта (OID) 1.2.840.113556.1.4.319.

Требования

Требование	Значение
Минимальная версия клиента	Windows Vista
Минимальная версия сервера	Windows Server 2008
Целевая платформа	Windows
Header	winldap.h
Библиотека	Wldap32.lib
DLL	Wldap32.dll