ldap_simple_bind函数 (winldap.h)
ldap_simple_bind函数使用纯文本密码以异步方式向服务器验证客户端。
谨慎 此函数发送名称和密码而不加密它们，因此在网络上窃听的人可能会读取密码。 除非已建立 TLS (SSL) 加密会话，否则请勿使用此函数。 有关如何设置加密会话的详细信息，请参阅 初始化会话。
语法
WINLDAPAPI ULONG LDAPAPI ldap_simple_bind(
[in] LDAP *ld,
[in] const PSTR dn,
[in] const PSTR passwd
);
参数
[in] ld
会话句柄。
[in] dn
要绑定为的用户的名称。 绑定操作使用 dn 和 passwd 参数对用户进行身份验证。
[in] passwd
dn 参数中指定的用户的密码。
返回值
如果函数成功，它将返回所启动操作的消息 ID。
如果函数失败，它将返回 -1 并在 LDAP 数据结构中设置会话错误参数。
注解
ldap_simple_bind 函数启动一个简单的异步绑定操作，以对 LDAP 服务器的客户端进行身份验证。 后续绑定调用可用于使用相同的连接重新进行身份验证。
若要以特定用户身份进行身份验证，请同时提供条目 (用户) 的名称以及该条目的密码。 若要对匿名用户进行身份验证，在不需要访问权限时，请将 NULL 传递给 dn 和 passwd 参数。
作为异步函数， ldap_simple_bind 返回操作的消息 ID。 使用消息 ID 调用 ldap_result 以获取操作的结果。 若要在异步绑定操作完成之前取消该操作， 请调用 ldap_abandon。 请注意，如果联系了 LDAP 2 服务器，则在绑定调用成功完成之前，不要尝试通过连接执行其他操作。
若要直接返回结果，请使用同步 例程ldap_simple_bind_s。
多线程处理：绑定调用不安全，因为它们作为一个整体应用于连接。 如果线程共享连接并尝试与其他操作进行线程绑定，请谨慎操作。
注意 Microsoft LDAP 客户端对每次绑定响应往返使用默认超时值 120 秒 (2 分钟) 。 可以使用 LDAP_OPT_TIMELIMIT 会话选项更改此超时值。 除非使用 ldap_set_option 指定，否则其他操作没有超时。
ldap_simple_bind函数旨在绑定到本地域。 函数不能用于跨林身份验证。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |