Share via


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