Estrutura LDAPSortKeyA (winldap.h)

Artigo
08/27/2023

A estrutura LDAPSortKey armazena critérios de classificação para uso por controles de classificação.

Sintaxe

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

Membros

sk_attrtype

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o nome do atributo a ser usado como uma chave de classificação. Use várias estruturas LDAPSortKey para especificar várias chaves de classificação. Lembre-se de que o Active Directory dá suporte apenas a uma única chave de classificação.

sk_matchruleoid

Ponteiro para uma cadeia de caracteres terminada em nulo que especifica o identificador de objeto da regra correspondente para a classificação. Deve ser definido como NULL se você não quiser especificar explicitamente uma regra de correspondência para a classificação. A especificação de uma regra de correspondência definida explicitamente tem suporte apenas pelo Windows Server 2003.

sk_reverseorder

Se TRUE, especifica que a classificação seja ordenada do mais baixo para o mais alto. Se FALSE, a ordem de classificação será da mais alta para a mais baixa.

Comentários

As funções ldap_create_sort_control e ldap_search_init_page usam essa estrutura para especificar como os resultados devem ser classificados antes de serem retornados ao cliente.

Observação

O cabeçalho winldap.h define LDAPSortKey como um alias que seleciona automaticamente a versão ANSI ou Unicode dessa função com base na definição da constante de pré-processador UNICODE. Misturar o uso do alias neutro de codificação com código que não seja neutro em codificação pode levar a incompatibilidades que resultam em erros de compilação ou de runtime. Para obter mais informações, consulte Convenções para protótipos de função.