функция ldap_create_sort_control (winldap.h)
Функция ldap_create_sort_control используется для форматирования списка ключей сортировки в элементе управления поиска. Поддержка элементов управления доступна в LDAP 3, но то, поддерживается ли элемент управления сортировкой, зависит от конкретного сервера.
Синтаксис
WINLDAPAPI ULONG LDAPAPI ldap_create_sort_control(
[in] PLDAP ExternalHandle,
[in] PLDAPSortKeyA *SortKeys,
[in] UCHAR IsCritical,
[out] PLDAPControlA *Control
);
Параметры
[in] ExternalHandle
Дескриптор сеанса.
[in] SortKeys
Указатель на массив структур LDAPSortKey . Каждая структура в массиве указывает имя атрибута, используемого в качестве ключа сортировки, правило сопоставления для этого ключа и порядок сортировки по возрастанию или убыванию.
[in] IsCritical
Уведомляет сервер о том, является ли этот элемент управления критически важным для поиска. 0 ==> FALSE, !0 ==> TRUE.
[out] Control
Указатель на только что созданный элемент управления.
Возвращаемое значение
Эта функция возвращает WINLDAPAPI ULONG LDAPAPI.
Комментарии
Функция ldap_create_sort_control создает базовый элемент управления сортировкой. Такой элемент управления полезен, если клиент LDAP имеет ограниченную функциональность и не может отсортировать результаты, но нуждается в их сортировке.
Элементы управления сортировкой позволяют серверу возвращать код результата для сортировки результатов, не зависящий от кода результата, возвращенного для операции поиска.
Эта функция создает элемент управления — она не проверяет, поддерживает ли сервер его, и, следовательно, не возвращает LDAP_UNAVAILABLE_CRIT_EXTENSION, если сервер не поддерживает элемент управления. Однако он может возвращать другие стандартные возвращаемые значения LDAP, например LDAP_NO_MEMORY или LDAP_PARAM_ERROR.
Чтобы освободить элемент управления, когда он больше не требуется, вызовите ldap_control_free.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | winldap.h |
| Библиотека | Wldap32.lib |
| DLL | Wldap32.dll |