_TOKEN_INFORMATION_CLASS Enumeration

The TOKEN_INFORMATION_CLASS enumeration contains values that specify the type of information being assigned to or retrieved from an access token.

The GetTokenInformation function uses these values to indicate the type of token information to retrieve.

The SetTokenInformation function uses these values to set the token information.

Syntax

typedef enum _TOKEN_INFORMATION_CLASS {
  TokenUser                             ,
  TokenGroups                           ,
  TokenPrivileges                       ,
  TokenOwner                            ,
  TokenPrimaryGroup                     ,
  TokenDefaultDacl                      ,
  TokenSource                           ,
  TokenType                             ,
  TokenImpersonationLevel               ,
  TokenStatistics                       ,
  TokenRestrictedSids                   ,
  TokenSessionId                        ,
  TokenGroupsAndPrivileges              ,
  TokenSessionReference                 ,
  TokenSandBoxInert                     ,
  TokenAuditPolicy                      ,
  TokenOrigin                           ,
  TokenElevationType                    ,
  TokenLinkedToken                      ,
  TokenElevation                        ,
  TokenHasRestrictions                  ,
  TokenAccessInformation                ,
  TokenVirtualizationAllowed            ,
  TokenVirtualizationEnabled            ,
  TokenIntegrityLevel                   ,
  TokenUIAccess                         ,
  TokenMandatoryPolicy                  ,
  TokenLogonSid                         ,
  TokenIsAppContainer                   ,
  TokenCapabilities                     ,
  TokenAppContainerSid                  ,
  TokenAppContainerNumber               ,
  TokenUserClaimAttributes              ,
  TokenDeviceClaimAttributes            ,
  TokenRestrictedUserClaimAttributes    ,
  TokenRestrictedDeviceClaimAttributes  ,
  TokenDeviceGroups                     ,
  TokenRestrictedDeviceGroups           ,
  TokenSecurityAttributes               ,
  TokenIsRestricted                     ,
  TokenProcessTrustLevel                ,
  TokenPrivateNameSpace                 ,
  TokenSingletonAttributes              ,
  TokenBnoIsolation                     ,
  TokenChildProcessFlags                ,
  TokenIsLessPrivilegedAppContainer     ,
  MaxTokenInfoClass
} TOKEN_INFORMATION_CLASS, *PTOKEN_INFORMATION_CLASS;

Constants

TokenUser The buffer receives a TOKEN_USER structure that contains the user account of the token.
TokenGroups The buffer receives a TOKEN_GROUPS structure that contains the group accounts associated with the token.
TokenPrivileges The buffer receives a TOKEN_PRIVILEGES structure that contains the privileges of the token.
TokenOwner The buffer receives a TOKEN_OWNER structure that contains the default owner security identifier (SID) for newly created objects.
TokenPrimaryGroup The buffer receives a TOKEN_PRIMARY_GROUP structure that contains the default primary group SID for newly created objects.
TokenDefaultDacl The buffer receives a TOKEN_DEFAULT_DACL structure that contains the default DACL for newly created objects.
TokenSource The buffer receives a TOKEN_SOURCE structure that contains the source of the token. TOKEN_QUERY_SOURCE access is needed to retrieve this information.
TokenType The buffer receives a TOKEN_TYPE value that indicates whether the token is a primary or impersonation token.
TokenImpersonationLevel The buffer receives a SECURITY_IMPERSONATION_LEVEL value that indicates the impersonation level of the token. If the access token is not an impersonation token, the function fails.
TokenStatistics The buffer receives a TOKEN_STATISTICS structure that contains various token statistics.
TokenRestrictedSids The buffer receives a TOKEN_GROUPS structure that contains the list of restricting SIDs in a restricted token.
TokenSessionId The buffer receives a DWORD value that indicates the Terminal Services session identifier that is associated with the token.

If the token is associated with the terminal server client session, the session identifier is nonzero.

Windows Server 2003 and Windows XP:  If the token is associated with the terminal server console session, the session identifier is zero.

In a non-Terminal Services environment, the session identifier is zero.

If TokenSessionId is set with SetTokenInformation, the application must have the Act As Part Of the Operating System privilege, and the application must be enabled to set the session ID in a token.

TokenGroupsAndPrivileges The buffer receives a TOKEN_GROUPS_AND_PRIVILEGES structure that contains the user SID, the group accounts, the restricted SIDs, and the authentication ID associated with the token.
TokenSessionReference Reserved.
TokenSandBoxInert The buffer receives a DWORD value that is nonzero if the token includes the SANDBOX_INERT flag.
TokenAuditPolicy Reserved.
TokenOrigin The buffer receives a TOKEN_ORIGIN value.

If the token resulted from a logon that used explicit credentials, such as passing a name, domain, and password to the LogonUser function, then the TOKEN_ORIGIN structure will contain the ID of the logon session that created it.

If the token resulted from network authentication, such as a call to AcceptSecurityContext or a call to LogonUser with dwLogonType set to LOGON32_LOGON_NETWORK or LOGON32_LOGON_NETWORK_CLEARTEXT, then this value will be zero.

TokenElevationType The buffer receives a TOKEN_ELEVATION_TYPE value that specifies the elevation level of the token.
TokenLinkedToken The buffer receives a TOKEN_LINKED_TOKEN structure that contains a handle to another token that is linked to this token.
TokenElevation The buffer receives a TOKEN_ELEVATION structure that specifies whether the token is elevated.
TokenHasRestrictions The buffer receives a DWORD value that is nonzero if the token has ever been filtered.
TokenAccessInformation The buffer receives a TOKEN_ACCESS_INFORMATION structure that specifies security information contained in the token.
TokenVirtualizationAllowed The buffer receives a DWORD value that is nonzero if virtualization is allowed for the token.
TokenVirtualizationEnabled The buffer receives a DWORD value that is nonzero if virtualization is enabled for the token.
TokenIntegrityLevel The buffer receives a TOKEN_MANDATORY_LABEL structure that specifies the token's integrity level.
TokenUIAccess The buffer receives a DWORD value that is nonzero if the token has the UIAccess flag set.
TokenMandatoryPolicy The buffer receives a TOKEN_MANDATORY_POLICY structure that specifies the token's mandatory integrity policy.
TokenLogonSid The buffer receives a TOKEN_GROUPS structure that specifies the token's logon SID.
TokenIsAppContainer The buffer receives a DWORD value that is nonzero if the token is an app container token. Any callers who check the TokenIsAppContainer and have it return 0 should also verify that the caller token is not an identify level impersonation token. If the current token is not an app container but is an identity level token, you should return AccessDenied.
TokenCapabilities The buffer receives a TOKEN_GROUPS structure that contains the capabilities associated with the token.
TokenAppContainerSid The buffer receives a TOKEN_APPCONTAINER_INFORMATION structure that contains the AppContainerSid associated with the token. If the token is not associated with an app container, the TokenAppContainer member of the TOKEN_APPCONTAINER_INFORMATION structure points to NULL.
TokenAppContainerNumber The buffer receives a DWORD value that includes the app container number for the token. For tokens that are not app container tokens, this value is zero.
TokenUserClaimAttributes The buffer receives a CLAIM_SECURITY_ATTRIBUTES_INFORMATION structure that contains the user claims associated with the token.
TokenDeviceClaimAttributes The buffer receives a CLAIM_SECURITY_ATTRIBUTES_INFORMATION structure that contains the device claims associated with the token.
TokenRestrictedUserClaimAttributes This value is reserved.
TokenRestrictedDeviceClaimAttributes This value is reserved.
TokenDeviceGroups The buffer receives a TOKEN_GROUPS structure that contains the device groups that are associated with the token.
TokenRestrictedDeviceGroups The buffer receives a TOKEN_GROUPS structure that contains the restricted device groups that are associated with the token.
TokenSecurityAttributes This value is reserved.
TokenIsRestricted This value is reserved.
TokenProcessTrustLevel
TokenPrivateNameSpace
TokenSingletonAttributes
TokenBnoIsolation
TokenChildProcessFlags
TokenIsLessPrivilegedAppContainer
MaxTokenInfoClass The maximum value for this enumeration.

Requirements

   
Windows version Windows XP [desktop apps only] Windows Server 2003 [desktop apps only]
Header winnt.h (include Windows.h)

See Also

Access Control

Authorization Enumerations

GetTokenInformation

SECURITY_IMPERSONATION_LEVEL

SetTokenInformation

TOKEN_CONTROL

TOKEN_DEFAULT_DACL

TOKEN_DEVICE_CLAIMS

TOKEN_GROUPS

TOKEN_GROUPS_AND_PRIVILEGES

TOKEN_ORIGIN

TOKEN_OWNER

TOKEN_PRIMARY_GROUP

TOKEN_PRIVILEGES

TOKEN_SOURCE

TOKEN_STATISTICS

TOKEN_TYPE

TOKEN_USER

TOKEN_USER_CLAIMS