ldap_simple_bind_s 函数 (winldap.h)

ldap_simple_bind_s 函数使用纯文本密码同步地向服务器对客户端进行身份验证。

谨慎此函数在不加密的情况下发送名称和密码，网络上未经授权的用户可以读取密码。除非已建立 TLS (SSL) 加密会话，否则不要执行此操作。有关如何设置加密会话的详细信息，请参阅初始化会话。

语法

WINLDAPAPI ULONG LDAPAPI ldap_simple_bind_s(
  [in] LDAP       *ld,
  [in] const PSTR dn,
  [in] const PSTR passwd
);

[in] ld

会话句柄。

[in] dn

要绑定为的用户的名称。绑定操作使用 dn 和 passwd 参数对用户进行身份验证。

[in] passwd

dn 参数中指定的用户的密码。

如果函数成功，则 返回值LDAP_SUCCESS。

如果该函数失败，它将返回错误代码。有关详细信息，请参阅返回值。

ldap_simple_bind_s 函数启动一个简单的同步绑定操作，以对 LDAP 服务器的客户端进行身份验证。后续绑定调用可用于使用相同的连接重新进行身份验证。

绑定操作完成后， ldap_simple_bind_s 返回给调用方。如果希望异步执行操作，请使用 ldap_simple_bind 。请注意，如果联系了 LDAP 2 服务器，则在绑定调用成功完成之前，不要尝试通过连接执行其他操作。

多线程处理：绑定调用不安全，因为它们作为一个整体应用于连接。如果线程共享连接，并尝试与其他操作进行线程绑定，请谨慎操作。

注意 Microsoft LDAP 客户端对每次绑定响应往返使用默认超时值 120 秒 (2 分钟) 。可以使用 LDAP_OPT_TIMELIMIT 会话选项更改此超时值。除非使用 ldap_set_option 指定，否则其他操作没有超时。

完成会话句柄上的所有操作后，通过将 LDAP 会话句柄传递给 ldap_unbind 函数来终止会话。此外，如果 ldap_simple_bind_s 调用失败，则当不再需要进行错误恢复时，应通过调用 ldap_unbind 来释放会话句柄。

返回值