Estructura LDAPSortKeyA (winldap.h)

Artículo
08/27/2023

La estructura LDAPSortKey almacena criterios de ordenación para su uso por controles de ordenación.

Sintaxis

typedef struct ldapsortkeyA {
  PCHAR   sk_attrtype;
  PCHAR   sk_matchruleoid;
  BOOLEAN sk_reverseorder;
} LDAPSortKeyA, *PLDAPSortKeyA;

Miembros

sk_attrtype

Puntero a una cadena terminada en null que especifica el nombre del atributo que se va a usar como clave de ordenación. Use varias estructuras LDAPSortKey para especificar varias claves de ordenación. Tenga en cuenta que Active Directory solo admite una clave de ordenación única.

sk_matchruleoid

Puntero a una cadena terminada en null que especifica el identificador de objeto de la regla de coincidencia para la ordenación. Debe establecerse en NULL si no desea especificar explícitamente una regla de coincidencia para la ordenación. La especificación de una regla de coincidencia establecida explícitamente solo es compatible con Windows Server 2003.

sk_reverseorder

Si es TRUE, especifica que la ordenación se ordene de menor a más alto. Si es FALSE, el criterio de ordenación es de mayor a menor.

Comentarios

Las funciones ldap_create_sort_control y ldap_search_init_page usan esta estructura para especificar cómo se deben ordenar los resultados antes de que se devuelvan al cliente.

Nota

El encabezado winldap.h define LDAPSortKey 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 Convenciones para prototipos de función.