Struttura LDAPSortKeyA (winldap.h)

Articolo
11/20/2024

La struttura LDAPSortKey archivia i criteri di ordinamento da usare per i controlli di ordinamento.

Sintassi

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

Membri

sk_attrtype

Puntatore a una stringa con terminazione Null che specifica il nome dell'attributo da usare come chiave di ordinamento. Usare più strutture LDAPSortKey per specificare più chiavi di ordinamento. Tenere presente che Active Directory supporta solo una singola chiave di ordinamento.

sk_matchruleoid

Puntatore a una stringa con terminazione Null che specifica l'identificatore dell'oggetto della regola di corrispondenza per l'ordinamento. Deve essere impostato su NULL se non si desidera specificare in modo esplicito una regola di corrispondenza per l'ordinamento. La specifica di una regola di corrispondenza impostata in modo esplicito è supportata solo da Windows Server 2003.

sk_reverseorder

Se TRUE, specifica che l'ordinamento deve essere ordinato dal più basso al più alto. Se FALSE, l'ordinamento è compreso tra il più alto e il più basso.

Osservazioni

Le funzioni ldap_create_sort_control e ldap_search_init_page usano questa struttura per specificare la modalità di ordinamento dei risultati prima di essere restituiti al client.

Nota

L'intestazione winldap.h definisce LDAPSortKey come alias che seleziona automaticamente la versione ANSI o Unicode di questa funzione in base alla definizione della costante del preprocessore UNICODE. La combinazione dell'utilizzo dell'alias indipendente dalla codifica con il codice non indipendente dalla codifica può causare mancate corrispondenze che generano errori di compilazione o di runtime. Per altre informazioni, vedere convenzioni di per i prototipi di funzioni.