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

Статья
08/07/2023

Структура TOKEN_STATISTICS содержит сведения о маркере доступа. Драйвер может получить эти сведения, вызвав SeQueryInformationToken или ZwQueryInformationToken.

Синтаксис

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

Члены

TokenId

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

AuthenticationId

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

ExpirationTime

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

TokenType

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

ImpersonationLevel

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

DynamicCharged

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

DynamicAvailable

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

GroupCount

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

PrivilegeCount

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

ModifiedId

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