estructura TOKEN_PRIVILEGES (winnt.h)

Artículo
08/27/2023

La estructura TOKEN_PRIVILEGES contiene información sobre un conjunto de privilegios para un token de acceso.

Sintaxis

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

Miembros

PrivilegeCount

Debe establecerse en el número de entradas de la matriz Privilegios .

Privileges[ANYSIZE_ARRAY]

Especifica una matriz de estructuras de LUID_AND_ATTRIBUTES . Cada estructura contiene el LUID y los atributos de un privilegio. Para obtener el nombre del privilegio asociado a un LUID, llame a la función LookupPrivilegeName y pase la dirección del LUID como valor del parámetro lpLuid .

Importante La constante ANYSIZE_ARRAY se define como 1 en el encabezado público Winnt.h. Para crear esta matriz con más de un elemento, debe asignar memoria suficiente para que la estructura tenga en cuenta elementos adicionales.

Los atributos de un privilegio pueden ser una combinación de los valores siguientes.

Valor	Significado
SE_PRIVILEGE_ENABLED	El privilegio está habilitado.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	El privilegio está habilitado de forma predeterminada.
SE_PRIVILEGE_REMOVED	Se usa para quitar un privilegio. Para obtener más información, consulte AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	El privilegio se usó para obtener acceso a un objeto o servicio. Esta marca se usa para identificar los privilegios pertinentes en un conjunto pasado por una aplicación cliente que puede contener privilegios innecesarios.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2003 [solo aplicaciones de escritorio]
Encabezado	winnt.h (incluya Windows.h)