Freigeben über


LDAPSortKeyA-Struktur (winldap.h)

Die LDAPSortKey- Struktur speichert Sortierkriterien für die Verwendung durch Sortiersteuerelemente.

Syntax

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

Angehörige

sk_attrtype

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Attributs angibt, das als Sortierschlüssel verwendet werden soll. Verwenden Sie mehrere LDAPSortKey- Strukturen, um mehrere Sortierschlüssel anzugeben. Beachten Sie, dass Active Directory nur einen einzelnen Sortierschlüssel unterstützt.

sk_matchruleoid

Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Objektbezeichner der übereinstimmenden Regel für die Sortierung angibt. Sollte auf NULL- festgelegt werden, wenn Sie keine übereinstimmende Regel für die Sortierung explizit angeben möchten. Die Angabe einer explizit festgelegten Übereinstimmungsregel wird nur von Windows Server 2003 unterstützt.

sk_reverseorder

Gibt TRUEan, dass die Sortierung von der niedrigsten zur höchsten Sortierung sortiert wird. Wenn FALSE-, ist die Sortierreihenfolge von der höchsten bis zur niedrigsten Sortierreihenfolge.

Bemerkungen

Die funktionen ldap_create_sort_control und ldap_search_init_page verwenden diese Struktur, um anzugeben, wie Ergebnisse sortiert werden sollen, bevor sie an den Client zurückgegeben werden.

Anmerkung

Der winldap.h-Header definiert LDAPSortKey als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung Wert
mindestens unterstützte Client- Windows Vista
mindestens unterstützte Server- Windows Server 2008
Header- winldap.h

Siehe auch

Datenstrukturen

LDAP_SERVER_SORT_OID

Verwenden von Steuerelementen

ldap_create_sort_control

ldap_search_init_page