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

토큰 개체의 이 instance 식별하는 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 포함)