Структура LDAPControlA (winldap.h)
Структура LDAPControl представляет как клиентские, так и серверные элементы управления.
Синтаксис
typedef struct ldapcontrolA {
PCHAR ldctl_oid;
struct berval ldctl_value;
BOOLEAN ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;
Члены
ldctl_oid
Указатель на широкую строку, завершающую значение NULL, которая указывает тип элемента управления, например "1.2.840.113556.1.4.805".
ldctl_value
Данные, связанные с элементом управления, если таковые есть. Если данные не связаны с элементом управления, задайте для этого элемента значение NULL.
ldctl_iscritical
Указывает, является ли элемент управления критически важным, называется полем "Критичность".
Замечания
Эффективное использование LDAP 3 позволяет расширить операции LDAP с помощью элементов управления. Серверные элементы управления могут быть отправлены на сервер или возвращены клиенту с любым сообщением LDAP. Клиентские элементы управления расширяют поведение API LDAP только на стороне клиента и никогда не отправляются на сервер. Поддерживаемый элемент управления хранится в качестве идентификатора объекта (OID) в корневом каталоге службы каталогов.
Элемент ldctl_iscritical позволяет выполнить расширенную операцию, если сервер или клиент не поддерживает элемент управления. Если значение этого поля равно нулю, сервер и (или) клиент игнорирует элемент управления, если он не поддерживается и выполняет операцию. Если значение ненулевое, операция выполняется только в том случае, если элемент управления распознается сервером или клиентом.
Дополнительные сведения и список поддерживаемых расширенных элементов управления LDAP и их описания см. в расширенных элементов управления.
Заметка
Заголовок winldap.h определяет LDAPControl как псевдоним, который автоматически выбирает версию ANSI или Юникод этой функции на основе определения константы препроцессора ЮНИКОДа. Сочетание использования псевдонима, нейтрального для кодирования, с кодом, не зависящим от кодирования, может привести к несоответствиям, которые приводят к ошибкам компиляции или среды выполнения. Дополнительные сведения см. в соглашениях о прототипах функций.
Требования
| Требование | Ценность |
|---|---|
| минимальные поддерживаемые клиентские | Windows Vista |
| минимальный поддерживаемый сервер | Windows Server 2008 |
| заголовка | winldap.h |