Función ldap_connect (winldap.h)

Artículo
03/08/2023

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