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

Статья
08/27/2023

Функция 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, см. в разделе Параметры сеанса. Дополнительные сведения о флагах см. в разделе 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