структура TOKEN_PRIVILEGES (winnt.h)

Статья
03/04/2024

Структура TOKEN_PRIVILEGES содержит сведения о наборе привилегий для маркера доступа.

Синтаксис

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

Члены

PrivilegeCount

Для этого параметра должно быть задано количество записей в массиве Privileges .

Privileges[ANYSIZE_ARRAY]

Задает массив структур LUID_AND_ATTRIBUTES . Каждая структура содержит LUID и атрибуты привилегии. Чтобы получить имя привилегии, связанной с LUID, вызовите функцию LookupPrivilegeName , передав адрес LUID в качестве значения параметра lpLuid .

Важно Константа ANYSIZE_ARRAY определяется как 1 в общедоступном заголовке Winnt.h. Чтобы создать этот массив с несколькими элементами, необходимо выделить достаточно памяти, чтобы структура учитывала дополнительные элементы.

Атрибуты привилегии могут быть комбинацией следующих значений.

Значение	Значение
SE_PRIVILEGE_ENABLED	Привилегия включена.
SE_PRIVILEGE_ENABLED_BY_DEFAULT	Привилегия включена по умолчанию.
SE_PRIVILEGE_REMOVED	Используется для удаления привилегии. Дополнительные сведения см. в разделе AdjustTokenPrivileges.
SE_PRIVILEGE_USED_FOR_ACCESS	Привилегия использовалась для получения доступа к объекту или службе. Этот флаг используется для определения соответствующих привилегий в наборе, передаваемом клиентским приложением, который может содержать ненужные привилегии.

Требования

Требование	Значение
Минимальная версия клиента	Windows XP [только классические приложения]
Минимальная версия сервера	Windows Server 2003 [только классические приложения]
Верхняя часть	winnt.h (включая Windows.h)