estrutura TOKEN_PRIVILEGES (winnt.h)

Artigo
03/08/2023

A estrutura TOKEN_PRIVILEGES contém informações sobre um conjunto de privilégios para um token de acesso.

Sintaxe

typedef struct _TOKEN_PRIVILEGES {
  DWORD               PrivilegeCount;
  LUID_AND_ATTRIBUTES Privileges[ANYSIZE_ARRAY];
} TOKEN_PRIVILEGES, *PTOKEN_PRIVILEGES;

Membros

PrivilegeCount

Isso deve ser definido como o número de entradas na matriz Privileges .

Privileges[ANYSIZE_ARRAY]

Especifica uma matriz de estruturas LUID_AND_ATTRIBUTES . Cada estrutura contém o LUID e os atributos de um privilégio. Para obter o nome do privilégio associado a um LUID, chame a função LookupPrivilegeName , passando o endereço do LUID como o valor do parâmetro lpLuid .

Importante A ANYSIZE_ARRAY constante é definida como 1 no cabeçalho público Winnt.h. Para criar essa matriz com mais de um elemento, você deve alocar memória suficiente para que a estrutura leve em conta elementos adicionais.

Os atributos de um privilégio podem ser uma combinação dos valores a seguir.

Valor	Significado
SE_PRIVILEGE_ENABLED	O privilégio está habilitado.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	O privilégio é habilitado por padrão.
SE_PRIVILEGE_REMOVED	Usado para remover um privilégio. Para obter detalhes, consulte AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	O privilégio foi usado para obter acesso a um objeto ou serviço. Esse sinalizador é usado para identificar os privilégios relevantes em um conjunto passado por um aplicativo cliente que pode conter privilégios desnecessários.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows XP [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2003 [somente aplicativos da área de trabalho]
Cabeçalho	winnt.h (inclua Windows.h)