función ldap_parse_sort_controlW (winldap.h)

La función ldap_parse_sort_control analiza el control de ordenación devuelto por el servidor.

Sintaxis

WINLDAPAPI ULONG LDAPAPI ldap_parse_sort_controlW(
  [in]  PLDAP         ExternalHandle,
  [in]  PLDAPControlW *Control,
  [out] ULONG         *Result,
  [out] PWCHAR        *Attribute
);

Parámetros

[in] ExternalHandle

Identificador de sesión.

[in] Control

El control devuelto desde el servidor, como se obtiene de una llamada a ldap_parse_result.

[out] Result

Código de resultado.

[out] Attribute

Puntero a una cadena terminada en null que contiene el nombre del atributo que provocó un error en la operación.

Valor devuelto

Si la función se ejecuta correctamente, se LDAP_SUCCESS el valor devuelto.

Si la función presenta un error, devuelve un código de error. Consulte Valores devueltos para obtener más información.

Comentarios

Cuando el servidor devuelve los resultados, devuelve un control en el mensaje SearchResultDone. Llame a ldap_parse_sort_control para analizar este control de ordenación.

Si se produce un error en la operación de ordenación, el servidor puede devolver el nombre del atributo que provocó el error. En este caso, llame a ldap_memfree para liberar el valor del atributo.

Nota

El encabezado winldap.h define ldap_parse_sort_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 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

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

Vea también

Funciones

Valores devueltos

ldap_memfree

ldap_parse_result