CTokenGroups Class

This class is a wrapper for the TOKEN_GROUPS structure.

Important

This class and its members cannot be used in applications that execute in the Windows Runtime.

class CTokenGroups

Members

Public Constructors

Name	Description
CTokenGroups::CTokenGroups	The constructor.
CTokenGroups::~CTokenGroups	The destructor.

Public Methods

Name	Description
CTokenGroups::Add	Adds a CSid or existing TOKEN_GROUPS structure to the CTokenGroups object.
CTokenGroups::Delete	Deletes a CSid and its associated attributes from the CTokenGroups object.
CTokenGroups::DeleteAll	Deletes all CSid objects and their associated attributes from the CTokenGroups object.
CTokenGroups::GetCount	Returns the number of CSid objects and associated attributes contained in the CTokenGroups object.
CTokenGroups::GetLength	Returns the size of the CTokenGroups object.
CTokenGroups::GetPTOKEN_GROUPS	Retrieves a pointer to the TOKEN_GROUPS structure.
CTokenGroups::GetSidsAndAttributes	Retrieves the CSid objects and attributes belonging to the CTokenGroups object.
CTokenGroups::LookupSid	Retrieves the attributes associated with a CSid object.

Public Operators

Name	Description
CTokenGroups::operator const TOKEN_GROUPS *	Casts the CTokenGroups object to a pointer to the TOKEN_GROUPS structure.
CTokenGroups::operator =	Assignment operator.

Remarks

An access token is an object that describes the security context of a process or thread and is allocated to each user logged onto a Windows NT or Windows 2000 system.

The CTokenGroups class is a wrapper for the TOKEN_GROUPS structure, containing information about the group security identifiers (SIDs) in an access token.

For an introduction to the access control model in Windows, see Access Control in the Windows SDK.

Requirements

Header: atlsecurity.h

See Also

Reference

CSid Class

Concepts

Security Sample

Other Resources

ATL Class Overview

Security Global Functions