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

Функция ldap_set_option задает параметры для блоков подключения. Дополнительные сведения о структурах см. в разделе Структуры данных.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_set_option(
  [in] LDAP       *ld,
  [in] int        option,
  [in] const void *invalue
);

Параметры

[in] ld

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

[in] option

Имя набора параметров.

[in] invalue

Указатель на значение, которое должно быть присвоено параметру. Фактический тип этого параметра зависит от параметра параметра . Константы LDAP_OPT_ON и LDAP_OPT_OFF можно задать для параметров с параметрами включения и выключения.

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

Если функция выполняется успешно, возвращаемое значение будет LDAP_SUCCESS.

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

Комментарии

Вызовите ldap_set_option для доступа к структуре LDAP , представляющей сеанс LDAP. Не пытайтесь напрямую изменить структуру данных LDAP.

Дополнительные сведения и описание необязательных параметров, которые применяются к сеансу LDAP, см. в разделе Параметры сеанса. Дополнительные сведения о флагах см. в разделе DsGetDcName.

Теперь можно цифровой подписывать или шифровать весь трафик LDAP на сервер WINDOWS LDAP и с него с помощью протокола проверки подлинности Kerberos. Эта новая функция обеспечивает целостность и конфиденциальность, необходимые для некоторых приложений. Имейте в виду, что использование SSL дает те же преимущества, но требует обширных регистраций сертификатов для сервера, а иногда и для клиента.

Чтобы включить подписывание и запечатывание, необходимо включить один из следующих параметров перед вызовом ldap_bind_s с LDAP_AUTH_NEGOTIATE для метода bind.

#define LDAP_OPT_SIGN      0x95
#define LDAP_OPT_ENCRYPT   0x96

Чтобы отключить подписывание и запечатывание, закройте подключение, вызвав ldap_unbind() в дескрипторе подключения.

Многопоточность. Вызовы к ldap_set_option небезопасны, так как они влияют на подключение в целом. Будьте осторожны, если потоки совместно используют подключения.

Требования

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

См. также раздел

DsGetDcName

Функции

Получение и настройка параметров сеанса

LDAP

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

ldap_get_option