cldap_open 函数 (winldap.h)
cldap_open 函数通过无连接用户数据报协议 (UDP) 服务与 LDAP 服务器建立会话。 这是使用 TCP/IP 的替代方法。
语法
WINLDAPAPI LDAP *LDAPAPI cldap_open(
[in] PSTR HostName,
[in] ULONG PortNumber
);
参数
[in] HostName
指向以 null 结尾的字符串的指针，该字符串包含表示 LDAP 服务器主机 IP 地址的主机名或虚线字符串的列表。 使用单个空格分隔列表中的主机名。 列表中的每个主机名后跟一个端口号。 可选端口号与主机本身分隔，冒号 (：) 。 LDAP 运行时尝试按列出的顺序与主机建立连接，在成功建立连接时停止。
[in] PortNumber
要使用的端口号。 如果未指定端口号，则默认值为端口 389，定义为LDAP_PORT。 如果 端口号包含在 HostName 参数中，则忽略此参数。
返回值
如果函数成功，则返回指向 LDAP 结构的指针形式的会话句柄。 当不再需要会话句柄时，通过调用 ldap_unbind 释放会话句柄。
如果函数失败，则返回值为 NULL。 若要获取错误代码，请调用 LdapGetLastError 或 Win32 函数 GetLastError。
注解
与 ldap_open 不同，cldap_open 函数为基于 UDP 的无连接 LDAP 服务创建连接块。 不维护 TCP 会话。 与 ldap_open一样， cldap_open 分配 LDAP 结构来维护会话的状态数据，然后在返回到调用方之前尝试建立连接。 调用将返回会话句柄，该句柄将传递给会话过程中的后续 LDAP 函数调用。 会话完成后，始终使用 ldap_unbind 释放分配的会话句柄。
使用基于 UDP 的 LDAP 不支持绑定，也不支持 TLS (SSL) 或 SASL。
多线程处理：对 cldap_open 的调用是线程安全的。
注意 使用 cldap_open 时，连接由匿名用户打开。 唯一可用的操作是匿名用户可以运行的操作。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |