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

Статья
08/27/2023

Структура TOKEN_STATISTICS содержит сведения о маркере доступа. Приложение может получить эти сведения, вызвав функцию GetTokenInformation .

Синтаксис

typedef struct _TOKEN_STATISTICS {
  LUID                         TokenId;
  LUID                         AuthenticationId;
  LARGE_INTEGER                ExpirationTime;
  TOKEN_TYPE                   TokenType;
  SECURITY_IMPERSONATION_LEVEL ImpersonationLevel;
  DWORD                        DynamicCharged;
  DWORD                        DynamicAvailable;
  DWORD                        GroupCount;
  DWORD                        PrivilegeCount;
  LUID                         ModifiedId;
} TOKEN_STATISTICS, *PTOKEN_STATISTICS;

Члены

TokenId

Задает локально уникальный идентификатор (LUID), который идентифицирует этот экземпляр объекта маркера.

AuthenticationId

Указывает LUID, назначенный сеансу , который представляет этот токен. Может быть много маркеров, представляющих один сеанс входа.

ExpirationTime

Указывает время истечения срока действия этого маркера. Срок действия маркеров доступа в настоящее время не поддерживается.

TokenType

Указывает тип перечисления TOKEN_TYPE , указывающий, является ли маркер первичным или олицетворением.

ImpersonationLevel

Задает тип перечисления SECURITY_IMPERSONATION_LEVEL , указывающий уровень олицетворения маркера. Этот член действителен, только если параметр TokenType имеет значение TokenImpersonation.

DynamicCharged

Указывает объем (в байтах) памяти, выделенной для хранения защиты по умолчанию, и идентификатора основной группы.

DynamicAvailable

Указывает часть памяти, выделенную для хранения защиты по умолчанию, и идентификатор основной группы, который еще не используется. Это значение возвращается в виде количества свободных байтов.

GroupCount

Указывает количество дополнительных идентификаторов безопасности группы (SID), включенных в маркер.

PrivilegeCount

Указывает количество привилегий, включенных в маркер.

ModifiedId

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

Требования

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