ldap_simple_bind函数 (winldap.h)

项目
08/27/2023

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 会话句柄传递给 ldap_unbind 函数来终止会话。此外，如果 ldap_simple_bind 调用失败，则当不再需要进行错误恢复时，应通过调用 ldap_unbind 来释放会话句柄。

ldap_simple_bind函数旨在绑定到本地域。函数不能用于跨林身份验证。

要求

要求	值
最低受支持的客户端	Windows Vista
最低受支持的服务器	Windows Server 2008
目标平台	Windows
标头	winldap.h
Library	Wldap32.lib
DLL	Wldap32.dll