функция cldap_open (winldap.h)
Функция 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 потокобезопасны.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows Vista |
| Минимальная версия сервера | Windows Server 2008 |
| Целевая платформа | Windows |
| Header | winldap.h |
| Библиотека | Wldap32.lib |
| DLL | Wldap32.dll |