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

Статья
08/27/2023

Функция ldap_simple_bind_s синхронно выполняет проверку подлинности клиента на сервере, используя пароль в виде открытого текста.

Осторожностью Эта функция отправляет имя и пароль, не шифруя их, и несанкционированный пользователь в сети может прочитать пароль. Если не был установлен сеанс с шифрованием TLS (SSL), не выполняйте эту функцию. Дополнительные сведения о настройке зашифрованного сеанса см. в разделе Инициализация сеанса.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_simple_bind_s(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

Параметры

[in] ld

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

[in] dn

Имя пользователя для привязки. Операция привязки использует параметры dn и passwd для проверки подлинности пользователя.

[in] passwd

Пароль пользователя, указанного в параметре dn .

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

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

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

Функция ldap_simple_bind_s инициирует простую синхронную операцию привязки для проверки подлинности клиента на сервере LDAP. Последующие вызовы привязки можно использовать для повторной проверки подлинности с помощью того же подключения.

После завершения операции привязки ldap_simple_bind_s возвращается вызывающей объекту. Используйте ldap_simple_bind , если вы предпочитаете выполнять операцию асинхронно. Имейте в виду, что при обращении к серверу LDAP 2 не пытайтесь выполнять другие операции через подключение, пока вызов привязки не завершится успешно.

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

Примечание Клиент Microsoft LDAP использует значение времени ожидания по умолчанию, равное 120 секундам (2 минуты) для каждой круговой операции bind-response. Это значение времени ожидания можно изменить с помощью параметра сеанса LDAP_OPT_TIMELIMIT . Другие операции не имеют времени ожидания, если не указано с помощью ldap_set_option.

После завершения всех операций с дескриптором сеанса завершите сеанс, передав дескриптор сеанса LDAP в функцию ldap_unbind . Кроме того, если вызов ldap_simple_bind_s завершается сбоем, дескриптор сеанса должен быть освобожден с помощью вызова ldap_unbind , если восстановление ошибок больше не требуется.

Требования


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