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