Función ldap_connect (winldap.h)
La función ldap_connect establece una conexión con el servidor.
Sintaxis
WINLDAPAPI ULONG LDAPAPI ldap_connect(
[in] LDAP *ld,
[in] l_timeval *timeout
);
Parámetros
[in] ld
Identificador de sesión obtenido de ldap_init.
[in] timeout
Puntero a una estructura de LDAP_TIMEVAL que especifica el número de segundos que se van a gastar en un intento de establecer una conexión antes de un tiempo de espera. Si es NULL, la función usa un valor de tiempo de espera predeterminado.
Valor devuelto
Si la función se ejecuta correctamente, se devuelve LDAP_SUCCESS .
Si se produce un error en la función, se devuelve un código de error. Para obtener más información, vea Valores devueltos.
Comentarios
Aunque no es necesario que una llamada de cliente ldap_connect para establecer una conexión con el servidor, es recomendable hacerlo. Si la conexión no existe, otras funciones, por ejemplo, ldap_bind_s, realice la llamada internamente. Sin embargo, si tiene que solucionar esta parte de la aplicación, establecer la conexión antes de realizar la llamada a alguna otra función, por ejemplo , ldap_bind_s, también separará los posibles problemas si se produce un error en la conexión. Como alternativa, puede especificar opciones adicionales en el bloque de conexión. Por ejemplo, un cliente puede llamar a ldap_init para inicializar una sesión y, a continuación, llamar a ldap_connect, con un valor de parámetro de tiempo de espera no NULL , para conectarse al servidor con un tiempo de espera especificado.
Si la llamada a ldap_connect se realiza correctamente, el cliente se conecta al servidor LDAP como un usuario anónimo. El identificador de sesión debe liberarse con una llamada a ldap_unbind cuando ya no sea necesario.
Si se produce un error en la llamada ldap_connect , el identificador de sesión debe liberarse con una llamada a ldap_unbind cuando ya no sea necesario para la recuperación de errores.
Requisitos
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Plataforma de destino | Windows |
| Encabezado | winldap.h |
| Library | Wldap32.lib |
| Archivo DLL | Wldap32.dll |