Estructura LDAPControlA (winldap.h)
La estructura LDAPControl representa los controles de servidor y del lado cliente.
Sintaxis
typedef struct ldapcontrolA {
PCHAR ldctl_oid;
struct berval ldctl_value;
BOOLEAN ldctl_iscritical;
} LDAPControlA, *PLDAPControlA;
Miembros
ldctl_oid
Puntero a una cadena ancha terminada en null que indica el tipo de control, como "1.2.840.113556.1.4.805".
ldctl_value
Los datos asociados al control, si los hay. Si no hay datos asociados al control, establezca este miembro en NULL.
ldctl_iscritical
Indica si el control es crítico, denominado campo Criticality.
Comentarios
Eficaz con LDAP 3, puede ampliar las operaciones LDAP mediante el uso de controles. Los controles de servidor se pueden enviar al servidor o devolverse al cliente con cualquier mensaje LDAP. Los controles de cliente amplían el comportamiento de la API LDAP solo en el lado cliente y nunca se envían al servidor. Un control admitido se almacena como un identificador de objeto (OID) en la raíz del servicio de directorio.
El miembro ldctl_iscritical permite que una operación extendida se realice correctamente cuando el servidor o el cliente no admiten el control. Si el valor de este campo es cero, el servidor o el cliente o omite el control si no se admite y lleva a cabo la operación. Si el valor es distinto de cero, la operación solo se lleva a cabo si el servidor o el cliente reconocen el control.
Para obtener más información y una lista de los controles extendidos LDAP admitidos y sus descripciones, vea Controles extendidos.
Nota
El encabezado winldap.h define LDAPControl como alias que selecciona automáticamente la versión ANSI o Unicode de esta función en función de la definición de la constante de preprocesador UNICODE. La combinación del uso del alias neutro de codificación con código que no es neutral de codificación puede provocar discrepancias que dan lugar a errores de compilación o en tiempo de ejecución. Para obtener más información, vea Convenciones para prototipos de función.
Requisitos
| Requisito | Value |
|---|---|
| Cliente mínimo compatible | Windows Vista |
| Servidor mínimo compatible | Windows Server 2008 |
| Encabezado | winldap.h |