función ldap_create_vlv_controlA (winldap.h)

Artículo
11/20/2024

La función ldap_create_vlv_control se usa para crear el control de solicitud (LDAP_CONTROL_VLVREQUEST) en el servidor.

Sintaxis

WINLDAPAPI INT LDAPAPI ldap_create_vlv_controlA(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPVLVInfo  VlvInfo,
  [in]  UCHAR         IsCritical,
  [out] PLDAPControlA *Control
);

Parámetros

[in] ExternalHandle

Un identificador de sesión LDAP, tal como se obtiene de una llamada a ldap_init.

[in] VlvInfo

La dirección de una LDAPVLVInfo estructura cuyo contenido se usa para construir el valor del control creado.

[in] IsCritical

Si este valor no es cero, el control creado tendrá su importancia establecida en TRUE.

[out] Control

Un parámetro de resultado asignado a la dirección de un LDAPControl estructura que contiene el control de solicitud (LDAP_CONTROL_VLVREQUEST) creado por esta función.

Valor devuelto

La función ldap_create_vlv_control devuelve un código de error LDAP para indicar un error o LDAP_SUCCESS si se ejecuta correctamente.

Observaciones

Cuando se realiza una búsqueda de VLV, el cliente debe usar esta función para crear un nuevo control VLV que se pueda incluir en la solicitud de búsqueda enviada al servidor. El servidor asignará un contextID para esta búsqueda de VLV, pasado al cliente. Una vez completada la búsqueda de VLV, debe usar ldap_control_free para liberar el control devuelto por ldap_create_vlv_controly ldap_controls_free liberar la matriz de controles, incluido el control de respuesta VLV, devuelto por ldap_parse_result.

Para obtener más información y un ejemplo de código para esta función, consulte código de ejemplo para usar VLV LDAP.

Nota

El encabezado winldap.h define ldap_create_vlv_control 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
de la plataforma de destino de	Windows
encabezado de	winldap.h
biblioteca de	Wldap32.lib
DLL de	Wldap32.dll