Estructura LDAPControlA (winldap.h)

La estructura LDAPControl de representa los controles del lado cliente y del servidor.

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 Crítico.

Observaciones

Efectivo 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 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, consulte 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 neutral de codificación con código que no es neutral de codificación puede dar lugar a errores de coincidencia que dan lugar a errores de compilación o tiempo de ejecución. Para obtener más información, vea Conventions for Function Prototypes.

Requisitos

Requisito	Valor
cliente mínimo admitido	Windows Vista
servidor mínimo admitido	Windows Server 2008
encabezado de	winldap.h

Consulte también

estructuras de datos de

LDAPMessage

usar controles