función ldap_set_option (winldap.h)
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 |