Structure LDAPSortKeyA (winldap.h)

Article
08/27/2023

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 correspondante 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 la valeur EST TRUE, spécifie que le tri doit être classé du plus bas au plus élevé. Si la valeur est FALSE, l’ordre de tri est du plus élevé 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.

Notes

L’en-tête winldap.h définit LDAPSortKey comme un 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.