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 版本。混合使用編碼中性別名與非編碼中性的程序代碼，可能會導致編譯或運行時間錯誤不符。如需詳細資訊，請參閱函式原型的慣例。

使用控件