Structure LDAPSortKeyA (winldap.h)

Article
11/20/2024

La structure LDAPSortKey stocke les critères de tri à utiliser par les contrôles de tri.

Syntaxe

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

Membres

sk_attrtype

Pointeur vers une chaîne terminée par null qui spécifie le nom de l’attribut à utiliser comme clé de tri. Utilisez plusieurs structures LDAPSortKey pour spécifier plusieurs clés de tri. N’oubliez pas qu’Active Directory ne prend en charge qu’une seule clé de tri.

sk_matchruleoid

Pointeur vers une chaîne terminée par null qui spécifie l’identificateur d’objet de la règle correspondante pour le tri. Doit être défini sur NULL si vous ne souhaitez pas spécifier explicitement une règle de correspondance pour le tri. La spécification d’une règle de correspondance définie explicitement est prise en charge uniquement par Windows Server 2003.

sk_reverseorder

Si TRUE, spécifie que le tri doit être trié du plus bas au plus élevé. Si FAUX, l’ordre de tri est de la plus haute au plus bas.

Remarques

Les fonctions ldap_create_sort_control et ldap_search_init_page utilisent cette structure pour spécifier la façon dont les résultats doivent être triés avant d’être retournés au client.

Note

L’en-tête winldap.h définit LDAPSortKey comme alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. Le mélange de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.