CTokenGroups-klasse

Opmerking

De ATL (Active Template Library) wordt nog steeds ondersteund. We voegen echter geen functies meer toe of werken de documentatie bij.

Deze klasse is een wrapper voor de TOKEN_GROUPS structuur.

Belangrijk

Deze klasse en de bijbehorende leden kunnen niet worden gebruikt in toepassingen die worden uitgevoerd in Windows Runtime.

Syntaxis

class CTokenGroups

Leden

Openbare constructors

Naam	Description
CTokenGroups::CTokenGroups	De constructor.
CTokenGroups::~CTokenGroups	De destructor.

Openbare methoden

Naam	Description
CTokenGroups::Toevoegen	Voegt een CSid of bestaande TOKEN_GROUPS structuur toe aan het CTokenGroups object.
CTokenGroups::D elete	Hiermee verwijdert u een CSid en de bijbehorende kenmerken uit het CTokenGroups object.
CTokenGroups::D eleteAll	Hiermee verwijdert u alle CSid objecten en de bijbehorende kenmerken uit het CTokenGroups object.
CTokenGroups::GetCount	Retourneert het aantal CSid objecten en bijbehorende kenmerken in het CTokenGroups object.
CTokenGroups::GetLength	Retourneert de grootte van het CTokenGroups object.
CTokenGroups::GetPTOKEN_GROUPS	Hiermee wordt een aanwijzer naar de TOKEN_GROUPS structuur opgehaald.
CTokenGroups::GetSidsAndAttributes	Hiermee worden de CSid objecten en kenmerken opgehaald die bij het CTokenGroups object horen.
CTokenGroups::LookupSid	Haalt de kenmerken op die zijn gekoppeld aan een CSid object.

Openbare operators

Naam	Description
CTokenGroups::operator const TOKEN_GROUPS *	Cast het CTokenGroups object naar een aanwijzer naar de TOKEN_GROUPS structuur.
CTokenGroups::operator =	Toewijzingsoperator.

Opmerkingen

Een toegangstoken is een object dat de beveiligingscontext van een proces of thread beschrijft en wordt toegewezen aan elke gebruiker die is aangemeld bij een Windows-systeem.

De CTokenGroups klasse is een wrapper voor de TOKEN_GROUPS structuur, met informatie over de beveiligings-id's (SID's) van de groep in een toegangstoken.

Zie Access Control in de Windows SDK voor een inleiding tot het toegangsbeheermodel in Windows.

Requirements

Koptekst: atlsecurity.h

CTokenGroups::Toevoegen

Voegt een CSid of bestaande TOKEN_GROUPS structuur toe aan het CTokenGroups object.

void Add(const CSid& rSid, DWORD dwAttributes) throw(... );
void Add(const TOKEN_GROUPS& rTokenGroups) throw(...);

Parameterwaarden

rSid
Een CSid-object .

dwAttributes
De kenmerken die u aan het CSid object wilt koppelen.

rTokenGroups
Een TOKEN_GROUPS structuur.

Opmerkingen

Met deze methoden worden een of meer CSid objecten en de bijbehorende kenmerken aan het CTokenGroups object toegevoegd.

CTokenGroups::CTokenGroups

De constructor.

CTokenGroups() throw();
CTokenGroups(const CTokenGroups& rhs) throw(... );
CTokenGroups(const TOKEN_GROUPS& rhs) throw(...);

Parameterwaarden

Rhs
Het CTokenGroups object of TOKEN_GROUPS structuur waarmee het CTokenGroups object moet worden gemaakt.

Opmerkingen

Het CTokenGroups object kan eventueel worden gemaakt met behulp van een TOKEN_GROUPS structuur of een eerder gedefinieerd CTokenGroups object.

CTokenGroups::~CTokenGroups

De destructor.

virtual ~CTokenGroups() throw();

Opmerkingen

Met de destructor worden alle toegewezen resources vrijgemaakt.

CTokenGroups::D elete

Hiermee verwijdert u een CSid en de bijbehorende kenmerken uit het CTokenGroups object.

bool Delete(const CSid& rSid) throw();

Parameterwaarden

rSid
Het CSid-object waarvoor de beveiligings-id (SID) en kenmerken moeten worden verwijderd.

Retourwaarde

Retourneert waar als de CSid is verwijderd, anders onwaar.

CTokenGroups::D eleteAll

Hiermee verwijdert u alle CSid objecten en de bijbehorende kenmerken uit het CTokenGroups object.

void DeleteAll() throw();

CTokenGroups::GetCount

Geeft als resultaat het aantal CSid objecten in CTokenGroups.

UINT GetCount() const throw();

Retourwaarde

Retourneert het aantal CSid-objecten en de bijbehorende kenmerken in het CTokenGroups object.

CTokenGroups::GetLength

Retourneert de grootte van het CTokenGroup object.

UINT GetLength() const throw();

Opmerkingen

Retourneert de totale grootte van het CTokenGroup object, in bytes.

CTokenGroups::GetPTOKEN_GROUPS

Hiermee wordt een aanwijzer naar de TOKEN_GROUPS structuur opgehaald.

const TOKEN_GROUPS* GetPTOKEN_GROUPS() const throw(...);

Retourwaarde

Hiermee wordt een aanwijzer opgehaald naar de TOKEN_GROUPS structuur die hoort bij het CTokenGroups toegangstokenobject.

CTokenGroups::GetSidsAndAttributes

Hiermee worden de CSid objecten opgehaald en (optioneel) de kenmerken die bij het CTokenGroups object horen.

void GetSidsAndAttributes(
    CSid::CSidArray* pSids,
    CAtlArray<DWORD>* pAttributes = NULL) const throw(...);

Parameterwaarden

pSids
Aanwijzer naar een matrix van CSid-objecten .

pAttributes
Aanwijzer naar een matrix met DWORD's. Als deze parameter wordt weggelaten of NULL, worden de kenmerken niet opgehaald.

Opmerkingen

Met deze methode worden alle objecten in het CSidCTokenGroups object opgesomd en geplaatst en (optioneel) de kenmerkvlagken in matrixobjecten geplaatst.

CTokenGroups::LookupSid

Haalt de kenmerken op die zijn gekoppeld aan een CSid object.

bool LookupSid(
    const CSid& rSid,
    DWORD* pdwAttributes = NULL) const throw();

Parameterwaarden

rSid
Het CSid-object .

pdwAttributes
Wijs een DWORD aan die het kenmerk van het CSid object accepteert. Als u dit weglaat of NULL, wordt het kenmerk niet opgehaald.

Retourwaarde

Retourneert waar als de CSid waarde is gevonden, anders onwaar.

Opmerkingen

Het instellen van pdwAttributes op NULL biedt een manier om het bestaan van het CSid kenmerk te bevestigen zonder toegang te krijgen tot het kenmerk. Houd er rekening mee dat deze methode niet moet worden gebruikt om toegangsrechten te controleren. Toepassingen moeten in plaats daarvan de methode CAccessToken::CheckTokenMembership gebruiken.

CTokenGroups::operator =

Toewijzingsoperator.

CTokenGroups& operator= (const TOKEN_GROUPS& rhs) throw(...);
CTokenGroups& operator= (const CTokenGroups& rhs) throw(...);

Parameterwaarden

Rhs
Het CTokenGroups object of TOKEN_GROUPS structuur die aan het CTokenGroups object moet worden toegewezen.

Retourwaarde

Retourneert het bijgewerkte CTokenGroups object.

CTokenGroups::operator const TOKEN_GROUPS *

Hiermee wordt een waarde omgezet in een aanwijzer naar de TOKEN_GROUPS structuur.

operator const TOKEN_GROUPS *() const throw(...);

Opmerkingen

Hiermee wordt een waarde omgezet in een aanwijzer naar de TOKEN_GROUPS structuur.

Zie ook

Beveiligingsvoorbeeld
CSid-klasse
Overzicht van klassen
Globale beveiligingsfuncties