función ldap_set_option (winldap.h)

Artículo
03/04/2024

La función ldap_set_option establece opciones en bloques de conexión. Para obtener más información sobre las estructuras, consulte Estructuras de datos.

Sintaxis

WINLDAPAPI ULONG LDAPAPI ldap_set_option(
  [in] LDAP       *ld,
  [in] int        option,
  [in] const void *invalue
);

Parámetros

[in] ld

Identificador de sesión.

[in] option

Nombre del conjunto de opciones.

[in] invalue

Puntero al valor que se va a proporcionar a la opción. El tipo real de este parámetro depende de la configuración del parámetro de opción. Las constantes LDAP_OPT_ON y LDAP_OPT_OFF se pueden proporcionar para las opciones que tienen la configuración activada o desactivada.

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

Llame a ldap_set_option para acceder a la estructura LDAP que representa una sesión LDAP. No intente modificar la estructura de datos LDAP directamente.

Para obtener más información y una descripción de la configuración opcional que se aplica a una sesión LDAP, vea Opciones de sesión. Para obtener más información sobre las marcas, vea DsGetDcName.

Ahora es posible firmar o cifrar digitalmente todo el tráfico LDAP hacia y desde un servidor LDAP de Windows mediante el protocolo de autenticación Kerberos. Esta nueva característica proporciona integridad y confidencialidad requeridas por algunas aplicaciones. Tenga en cuenta que el uso de Capa de sockets seguros (SSL) le proporcionará las mismas ventajas, pero requiere amplias inscripciones de certificados para el servidor y, a veces, para el cliente.

Para habilitar la firma y el sellado, debe activar una de las siguientes opciones antes de llamar a ldap_bind_s con LDAP_AUTH_NEGOTIATE para el método bind.

#define LDAP_OPT_SIGN      0x95
#define LDAP_OPT_ENCRYPT   0x96

Para desactivar la firma y el sellado, cierre la conexión llamando a ldap_unbind() en el identificador de conexión.

Multithreading: las llamadas a ldap_set_option no son seguras porque afecta a la conexión en su conjunto. Tenga cuidado si los subprocesos comparten conexiones.

Requisitos

Requisito	Value
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