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

Статья
08/27/2023

Функция cldap_open устанавливает сеанс с сервером LDAP через службу UDP без подключения. Это альтернатива использованию TCP/IP.

Синтаксис

WINLDAPAPI LDAP *LDAPAPI cldap_open(
  [in] PSTR  HostName,
  [in] ULONG PortNumber
);

Параметры

[in] HostName

Указатель на строку, завершающуюся значением NULL, которая содержит список имен узлов или пунктирные строки, представляющие IP-адрес узлов сервера LDAP. Используйте одно пространство для разделения имен узлов в списке. За каждым именем узла в списке может следовать номер порта. Необязательный номер порта отделяется от самого узла двоеточием (:). Во время выполнения LDAP пытается подключиться к узлам в указанном порядке, останавливаясь при успешном подключении.

[in] PortNumber

Используемый номер порта. Если номер порта не указан, по умолчанию используется порт 389, который определяется как LDAP_PORT. Если номера портов включены в параметр HostName , этот параметр игнорируется.

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

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

Если функция завершается сбоем, возвращается значение NULL. Чтобы получить код ошибки, вызовите LdapGetLastError или функцию Win32 GetLastError.

Функция cldap_open , в отличие от ldap_open, создает блок подключения для служб LDAP без подключения на основе UDP. Сеанс TCP не поддерживается. Как и ldap_open, cldap_open выделяет структуру LDAP для хранения данных о состоянии сеанса, а затем пытается установить соединение перед возвратом вызывающей стороны. Вызов возвращает дескриптор сеанса, который передается в последующие вызовы функции LDAP в ходе сеанса. По завершении сеанса всегда освобождайте выделенный дескриптор сеанса с помощью ldap_unbind.

Использование ПРОТОКОЛА LDAP через UDP не поддерживает привязку и не поддерживает TLS (SSL) или SASL.

Многопоточность. Вызовы cldap_open потокобезопасны.

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

Требования

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