Функция ldap_connect (winldap.h)

Статья
08/27/2023

Функция ldap_connect устанавливает соединение с сервером.

Синтаксис

WINLDAPAPI ULONG LDAPAPI ldap_connect(
  [in] LDAP      *ld,
  [in] l_timeval *timeout
);

Параметры

[in] ld

Дескриптор сеанса, полученный из ldap_init.

[in] timeout

Указатель на структуру LDAP_TIMEVAL , указывающую количество секунд, затрачивается на попытку установить соединение до истечения времени ожидания. Если значение NULL, функция использует значение времени ожидания по умолчанию.

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

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

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

Хотя не требуется, чтобы клиент вызывал ldap_connect для установления соединения с сервером, это рекомендуется по программированию. Если подключение не существует, другие функции, например , ldap_bind_s, выполните внутренний вызов. Однако если необходимо устранить неполадки с этой частью приложения, установка подключения перед вызовом какой-то другой функции, например ldap_bind_s, также отделит возможные проблемы в случае сбоя подключения. Кроме того, можно указать дополнительные параметры в блоке подключения. Например, клиент может вызвать ldap_init для инициализации сеанса, а затем вызвать ldap_connect со значением времени ожидания, отличного от NULL , для подключения к серверу с указанным временем ожидания.

Если вызов ldap_connect выполнен успешно, клиент подключается к серверу LDAP в качестве анонимного пользователя. Дескриптор сеанса должен быть освобожден с помощью вызова ldap_unbind , когда он больше не требуется.

Если вызов ldap_connect завершается сбоем, дескриптор сеанса должен быть освобожден с вызовом ldap_unbind , если для восстановления ошибок больше не требуется.

Требования


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