CTokenGroups – třída

Tato třída je obálka pro TOKEN_GROUPS strukturu.

Důležité

Tuto třídu a její členy nelze použít v aplikacích, které se spouští v prostředí Windows Runtime.

Syntaxe

class CTokenGroups

Členové

Veřejné konstruktory

Název	Popis
CTokenGroups::CTokenGroups	Konstruktor
CTokenGroups::~CTokenGroups	Destruktor.

Veřejné metody

Název	Popis
CTokenGroups::Add	CSid Přidá do objektu CTokenGroups nebo existující TOKEN_GROUPS strukturu.
CTokenGroups::D elete	Odstraní a CSid jeho přidružené atributy z objektu CTokenGroups .
CTokenGroups::D eleteAll	Odstraní všechny CSid objekty a jejich přidružené atributy z objektu CTokenGroups .
CTokenGroups::GetCount	Vrátí počet CSid objektů a přidružených atributů obsažených v objektu CTokenGroups .
CTokenGroups::GetLength	Vrátí velikost objektu CTokenGroups .
CTokenGroups::GetPTOKEN_GROUPS	Načte ukazatel na TOKEN_GROUPS strukturu.
CTokenGroups::GetSidsAndAttributes	CSid Načte objekty a atributy, které patří do objektuCTokenGroups.
CTokenGroups::LookupSid	Načte atributy přidružené k objektu CSid .

Veřejné operátory

Název	Popis
CTokenGroups::operator const TOKEN_GROUPS *	Přetypuje CTokenGroups objekt na ukazatel na TOKEN_GROUPS strukturu.
CTokenGroups::operator =	Operátor přiřazení.

Poznámky

Přístupový token je objekt, který popisuje kontext zabezpečení procesu nebo vlákna a je přidělen každému uživateli přihlášeným k systému Windows.

Třída CTokenGroups je obálka pro TOKEN_GROUPS strukturu, která obsahuje informace o identifikátorech zabezpečení skupiny (SID) v přístupovém tokenu.

Úvod k modelu řízení přístupu ve Windows najdete v tématu Řízení přístupu v sadě Windows SDK.

Požadavky

Hlavička: atlsecurity.h

CTokenGroups::Add

CSid Přidá do objektu CTokenGroups nebo existující TOKEN_GROUPS strukturu.

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

Parametry

rSid
Objekt CSid .

dwAttributes
Atributy, které chcete přidružit k objektu CSid .

rTokenGroups
Struktura TOKEN_GROUPS .

Poznámky

Tyto metody přidají jeden nebo více CSid objektů a jejich přidružené atributy k objektu CTokenGroups .

CTokenGroups::CTokenGroups

Konstruktor

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

Parametry

rhs
Objekt CTokenGroups nebo TOKEN_GROUPS struktura, se kterou se má objekt sestavit CTokenGroups .

Poznámky

Objekt CTokenGroups lze volitelně vytvořit pomocí TOKEN_GROUPS struktury nebo dříve definovaného CTokenGroups objektu.

CTokenGroups::~CTokenGroups

Destruktor.

virtual ~CTokenGroups() throw();

Poznámky

Destruktor uvolní všechny přidělené prostředky.

CTokenGroups::D elete

Odstraní a CSid jeho přidružené atributy z objektu CTokenGroups .

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

Parametry

rSid
Objekt CSid , pro který má být odebrán identifikátor zabezpečení (SID) a atributy.

Návratová hodnota

Vrátí hodnotu true, pokud CSid je odebrána, jinak nepravda.

CTokenGroups::D eleteAll

Odstraní všechny CSid objekty a jejich přidružené atributy z objektu CTokenGroups .

void DeleteAll() throw();

CTokenGroups::GetCount

Vrátí počet objektů obsažených CSid v CTokenGroups.

UINT GetCount() const throw();

Návratová hodnota

Vrátí počet objektů CSid a jejich přidružené atributy obsažené v objektu CTokenGroups .

CTokenGroups::GetLength

Vrátí velikost objektu CTokenGroup .

UINT GetLength() const throw();

Poznámky

Vrátí celkovou velikost objektu CTokenGroup v bajtech.

CTokenGroups::GetPTOKEN_GROUPS

Načte ukazatel na TOKEN_GROUPS strukturu.

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

Návratová hodnota

Načte ukazatel na TOKEN_GROUPS strukturu patřící objektu přístupového tokenu CTokenGroups .

CTokenGroups::GetSidsAndAttributes

CSid Načte objekty a (volitelně) atributy, které patří do objektuCTokenGroups.

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

Parametry

pSids
Ukazatel na pole objektů CSid .

pAttributes
Ukazatel na pole DWORD. Pokud je tento parametr vynechán nebo null, atributy se nenačtou.

Poznámky

Tato metoda zobrazí výčet všech CSid objektů obsažených v objektu CTokenGroups a umístí je a (volitelně) příznaky atributů do objektů pole.

CTokenGroups::LookupSid

Načte atributy přidružené k objektu CSid .

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

Parametry

rSid
Objekt CSid .

pdwAttributes
Ukazatel na DWORD, který přijme CSid atribut objektu. Pokud tento atribut vynecháte nebo hodnotu NULL vynecháte, atribut se nenačte.

Návratová hodnota

Vrátí hodnotu true, pokud je nalezena CSid , v opačném případě false.

Poznámky

Nastavení pdwAttributes na NULL poskytuje způsob potvrzení existence atributu CSid bez přístupu k atributu. Všimněte si, že tato metoda by neměla být použita ke kontrole přístupových práv. Aplikace by místo toho měly použít metodu CAccessToken::CheckTokenMembership .

CTokenGroups::operator =

Operátor přiřazení.

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

Parametry

rhs
Objekt CTokenGroups nebo TOKEN_GROUPS strukturu, která se má objektu CTokenGroups přiřadit.

Návratová hodnota

Vrátí aktualizovaný CTokenGroups objekt.

CTokenGroups::operator const TOKEN_GROUPS *

Přetypuje hodnotu na ukazatel na TOKEN_GROUPS strukturu.

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

Poznámky

Přetypuje hodnotu na ukazatel na TOKEN_GROUPS strukturu.

Viz také

Ukázka zabezpečení
CSid – třída
Přehled třídy
Globální funkce zabezpečení