CTokenGroups-Klasse

Diese Klasse ist ein Wrapper für die TOKEN_GROUPS Struktur.

Wichtig

Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.

Syntax

class CTokenGroups

Member

Öffentliche Konstruktoren

Name	Beschreibung
CTokenGroups::CTokenGroups	Der Konstruktor.
CTokenGroups::~CTokenGroups	Der Destruktor.

Öffentliche Methoden

Name	Beschreibung
CTokenGroups::Add	Fügt dem CTokenGroups Objekt eine CSid oder eine vorhandene TOKEN_GROUPS Struktur hinzu.
CTokenGroups::D elete	Löscht ein CSid und die zugehörigen Attribute aus dem CTokenGroups Objekt.
CTokenGroups::D eleteAll	Löscht alle CSid Objekte und die zugehörigen Attribute aus dem CTokenGroups Objekt.
CTokenGroups::GetCount	Gibt die Anzahl der CSid Objekte und zugeordneten Attribute zurück, die CTokenGroups im Objekt enthalten sind.
CTokenGroups::GetLength	Gibt die Größe des CTokenGroups Objekts zurück.
CTokenGroups::GetPTOKEN_GROUPS	Ruft einen Zeiger auf die TOKEN_GROUPS Struktur ab.
CTokenGroups::GetSidsAndAttributes	Ruft die CSid Objekte und Attribute ab, die zum CTokenGroups Objekt gehören.
CTokenGroups::LookupSid	Ruft die Attribute ab, die einem CSid Objekt zugeordnet sind.

Öffentliche Operatoren

Name	Beschreibung
CTokenGroups::operator const TOKEN_GROUPS *	Wandelt das CTokenGroups Objekt in einen Zeiger auf die TOKEN_GROUPS Struktur um.
CTokenGroups::operator =	Zuweisungsoperator.

Hinweise

Ein Zugriffstoken ist ein Objekt, das den Sicherheitskontext eines Prozesses oder Threads beschreibt und jedem Benutzer zugewiesen wird, der bei einem Windows-System angemeldet ist.

Die CTokenGroups Klasse ist ein Wrapper für die TOKEN_GROUPS Struktur, die Informationen zu den Gruppensicherheits-IDs (SIDs) in einem Zugriffstoken enthält.

Eine Einführung in das Zugriffssteuerungsmodell in Windows finden Sie unter Access Control im Windows SDK.

Anforderungen

Kopfzeile: atlsecurity.h

CTokenGroups::Add

Fügt dem CTokenGroups Objekt eine CSid oder eine vorhandene TOKEN_GROUPS Struktur hinzu.

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

Parameter

rSid
Ein CSid-Objekt .

dwAttributes
Die Attribute, die dem CSid Objekt zugeordnet werden sollen.

rTokenGroups
Eine TOKEN_GROUPS Struktur.

Hinweise

Diese Methoden fügen ein oder CSid mehrere Objekte und die zugehörigen Attribute zum Objekt hinzu CTokenGroups .

CTokenGroups::CTokenGroups

Der Konstruktor.

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

Parameter

rhs
Das CTokenGroups Objekt oder TOKEN_GROUPS Struktur, mit der das CTokenGroups Objekt erstellt werden soll.

Hinweise

Das CTokenGroups Objekt kann optional mithilfe einer TOKEN_GROUPS Struktur oder eines zuvor definierten CTokenGroups Objekts erstellt werden.

CTokenGroups::~CTokenGroups

Der Destruktor.

virtual ~CTokenGroups() throw();

Hinweise

Der Destruktor gibt alle zugeordneten Ressourcen frei.

CTokenGroups::D elete

Löscht ein CSid und die zugehörigen Attribute aus dem CTokenGroups Objekt.

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

Parameter

rSid
Das CSid-Objekt , für das die Sicherheits-ID (SID) und Attribute entfernt werden sollen.

Rückgabewert

Gibt "true" zurück, wenn der CSid Wert entfernt wird, andernfalls "false".

CTokenGroups::D eleteAll

Löscht alle CSid Objekte und die zugehörigen Attribute aus dem CTokenGroups Objekt.

void DeleteAll() throw();

CTokenGroups::GetCount

Gibt die Anzahl der CSid Objekte zurück, die in CTokenGroups.

UINT GetCount() const throw();

Rückgabewert

Gibt die Anzahl der CSid-Objekte und deren zugeordneten Attribute zurück, die CTokenGroups im Objekt enthalten sind.

CTokenGroups::GetLength

Gibt die Größe des CTokenGroup Objekts zurück.

UINT GetLength() const throw();

Hinweise

Gibt die Gesamtgröße des CTokenGroup Objekts in Byte zurück.

CTokenGroups::GetPTOKEN_GROUPS

Ruft einen Zeiger auf die TOKEN_GROUPS Struktur ab.

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

Rückgabewert

Ruft einen Zeiger auf die TOKEN_GROUPS Struktur ab, die zum CTokenGroups Zugriffstokenobjekt gehört.

CTokenGroups::GetSidsAndAttributes

Ruft die CSid Objekte ab und (optional) die Attribute, die zum CTokenGroups Objekt gehören.

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

Parameter

pSids
Zeigen Sie auf ein Array von CSid-Objekten .

pAttributes
Zeiger auf ein Array von DWORDs. Wenn dieser Parameter nicht angegeben oder NULL ist, werden die Attribute nicht abgerufen.

Hinweise

Mit dieser Methode werden alle CSid im CTokenGroups Objekt enthaltenen Objekte aufgelistet und (optional) die Attributkennzeichnungen in Arrayobjekte platziert.

CTokenGroups::LookupSid

Ruft die Attribute ab, die einem CSid Objekt zugeordnet sind.

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

Parameter

rSid
Das CSid-Objekt .

pdwAttributes
Zeiger auf ein DWORD, das das Attribut des CSid Objekts akzeptiert. Wird das Attribut nicht angegeben oder NULL, wird das Attribut nicht abgerufen.

Rückgabewert

Gibt "true" zurück, wenn der CSid Gefundene gefunden wird, andernfalls "false".

Hinweise

Das Festlegen von pdwAttributes auf NULL bietet eine Möglichkeit, das Vorhandensein des CSid Attributs ohne Zugriff auf das Attribut zu bestätigen. Beachten Sie, dass diese Methode nicht zum Überprüfen von Zugriffsrechten verwendet werden sollte. Anwendungen sollten stattdessen die CAccessToken::CheckTokenMembership-Methode verwenden.

CTokenGroups::operator =

Zuweisungsoperator.

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

Parameter

rhs
Das CTokenGroups Objekt oder TOKEN_GROUPS Struktur, das dem CTokenGroups Objekt zugewiesen werden soll.

Rückgabewert

Gibt das aktualisierte Objekt zurück CTokenGroups .

CTokenGroups::operator const TOKEN_GROUPS *

Wandelt einen Wert in einen Zeiger auf die TOKEN_GROUPS Struktur um.

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

Hinweise

Wandelt einen Wert in einen Zeiger auf die TOKEN_GROUPS Struktur um.

Siehe auch

Sicherheitsbeispiel
CSid-Klasse
Klassenübersicht
Globale Sicherheitsfunktionen