ldap_connect 函数 (winldap.h)
ldap_connect 函数与服务器建立连接。
语法
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
参数
[in] ld
从 ldap_init 获取的会话句柄。
[in] timeout
指向 LDAP_TIMEVAL 结构的指针，该结构指定在超时前尝试建立连接所花费的秒数。 如果 为 NULL，则函数使用默认超时值。
返回值
如果函数成功，则返回 LDAP_SUCCESS 。
如果函数失败，则返回错误代码。 有关详细信息，请参阅 返回值。
注解
虽然不需要客户端调用 ldap_connect 来建立与服务器的连接，但这样做是很好的编程做法。 如果连接不存在，则其他函数（例如 ，ldap_bind_s）在内部执行调用。 但是，如果必须对应用程序的这一部分进行故障排除，在调用其他函数（例如 ldap_bind_s）之前建立连接，也会在连接失败时分离可能的问题。 或者，可以在连接块上指定其他选项。 例如，客户端可以调用ldap_init来初始化会话，然后调用具有非 NULL 超时参数值的ldap_connect，以连接到具有指定超时的服务器。
如果对 ldap_connect 调用成功，则客户端将作为匿名用户连接到 LDAP 服务器。 当不再需要会话句柄时，应通过调用 ldap_unbind 来释放会话句柄。
如果 ldap_connect 调用失败，则不再需要执行错误恢复时，应通过调用 ldap_unbind 来释放会话句柄。
要求
| 最低受支持的客户端 | Windows Vista |
| 最低受支持的服务器 | Windows Server 2008 |
| 目标平台 | Windows |
| 标头 | winldap.h |
| Library | Wldap32.lib |
| DLL | Wldap32.dll |
另请参阅
返回值