función ldap_simple_bind_s (winldap.h)

Artículo
08/27/2023

La función ldap_simple_bind_s autentica de forma sincrónica un cliente en un servidor mediante una contraseña de texto no cifrado.

Precaución Esta función envía el nombre y la contraseña sin cifrarlos, y un usuario no autorizado, en la red, podría leer la contraseña. A menos que se haya establecido una sesión cifrada de TLS (SSL), no esta función. Para obtener más información sobre cómo configurar una sesión cifrada, consulte Inicialización de una sesión.

Sintaxis

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

Parámetros

[in] ld

Identificador de sesión.

[in] dn

Nombre del usuario que se va a enlazar. La operación de enlace usa los parámetros dn y passwd para autenticar al usuario.

[in] passwd

Contraseña del usuario especificado en el parámetro dn .

Valor devuelto

Si la función se ejecuta correctamente, el valor devuelto es LDAP_SUCCESS.

Si la función presenta un error, devuelve un código de error. Para obtener más información, vea Valores devueltos.

Comentarios

La función ldap_simple_bind_s inicia una operación de enlace sincrónica simple para autenticar un cliente en un servidor LDAP. Las llamadas de enlace posteriores se pueden usar para volver a autenticarse mediante la misma conexión.

Tras la finalización de la operación de enlace, ldap_simple_bind_s vuelve al autor de la llamada. Use ldap_simple_bind si prefiere realizar la operación de forma asincrónica. Tenga en cuenta que si se establece contacto con un servidor LDAP 2, no intente otras operaciones a través de la conexión hasta que la llamada de enlace se haya completado correctamente.

Multithreading: las llamadas de enlace no son seguras porque se aplican a la conexión en su conjunto. Tenga cuidado si los subprocesos comparten conexiones e intente enlazarlos con otras operaciones.

Nota El cliente LDAP de Microsoft usa un valor de tiempo de espera predeterminado de 120 segundos (2 minutos) para cada ida y vuelta de respuesta de enlace. Este valor de tiempo de espera se puede cambiar mediante la opción LDAP_OPT_TIMELIMIT sesión. Otras operaciones no tienen un tiempo de espera a menos que se especifique mediante ldap_set_option.

Cuando se completen todas las operaciones del identificador de sesión, finalice la sesión pasando el identificador de sesión LDAP a la función ldap_unbind . Además, si se produce un error en la llamada ldap_simple_bind_s , 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