ldapSortKeyA 结构 (winldap.h)

LDAPSortKey 结构存储排序条件，供排序控件使用。

语法

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

sk_attrtype

指向以 null 结尾的字符串的指针，该字符串指定要用作排序键的属性的名称。使用多个 LDAPSortKey 结构指定多个排序键。请注意，Active Directory 仅支持单个排序键。

sk_matchruleoid

指向以 null 结尾的字符串的指针，该字符串指定排序的匹配规则的对象标识符。如果不想显式指定排序的匹配规则，应设置为 NULL 。仅 Windows Server 2003 支持指定显式设置的匹配规则。

sk_reverseorder

如果 为 TRUE，则指定排序顺序从低到高。如果 为 FALSE，则排序顺序从高到低。

ldap_create_sort_control和ldap_search_init_page函数使用此结构来指定在返回给客户端之前应如何对结果进行排序。

注意

winldap.h 标头将 LDAPSortKey 定义为别名，该别名根据 UNICODE 预处理器常量的定义自动选择此函数的 ANSI 或 Unicode 版本。将非特定编码别名与非非特定编码的代码混合使用可能会导致不匹配，从而导致编译或运行时错误。有关详细信息，请参阅函数原型的约定。