Klasa CTokenGroups

Ta klasa jest otoką struktury TOKEN_GROUPS .

Ważne

Tej klasy i jej składowych nie można używać w aplikacjach wykonywanych w środowisko wykonawcze systemu Windows.

Składnia

class CTokenGroups

Elementy członkowskie

Konstruktory publiczne

Nazwa/nazwisko	opis
CTokenGroups::CTokenGroups	Konstruktor.
CTokenGroups::~CTokenGroups	Destruktora.

Metody publiczne

Nazwa/nazwisko	opis
CTokenGroups::Add	Dodaje lub istniejącą CSid TOKEN_GROUPS strukturę do CTokenGroups obiektu.
CTokenGroups::D elete	Usuwa atrybuty CSid i skojarzone z nim CTokenGroups z obiektu.
CTokenGroups::D eleteAll	Usuwa wszystkie CSid obiekty i skojarzone z nimi atrybuty z CTokenGroups obiektu.
CTokenGroups::GetCount	Zwraca liczbę CSid obiektów i skojarzonych atrybutów zawartych w CTokenGroups obiekcie.
CTokenGroups::GetLength	Zwraca rozmiar CTokenGroups obiektu.
CTokenGroups::GetPTOKEN_GROUPS	Pobiera wskaźnik do TOKEN_GROUPS struktury.
CTokenGroups::GetSidsAndAttributes	CSid Pobiera obiekty i atrybuty należące do CTokenGroups obiektu.
CTokenGroups::LookupSid	Pobiera atrybuty skojarzone z obiektem CSid .

Operatory publiczne

Nazwa/nazwisko	opis
CTokenGroups::operator const TOKEN_GROUPS *	Rzutuje CTokenGroups obiekt na wskaźnik do TOKEN_GROUPS struktury.
CTokenGroups::operator =	Operator przypisania.

Uwagi

Token dostępu to obiekt, który opisuje kontekst zabezpieczeń procesu lub wątku i jest przydzielany każdemu użytkownikowi zalogowanego do systemu Windows.

Klasa CTokenGroups jest otoką struktury TOKEN_GROUPS zawierającą informacje o identyfikatorach zabezpieczeń grupy (SID) w tokenie dostępu.

Aby zapoznać się z wprowadzeniem do modelu kontroli dostępu w systemie Windows, zobacz Kontrola dostępu w zestawie Windows SDK.

Wymagania

Nagłówek: atlsecurity.h

CTokenGroups::Add

Dodaje lub istniejącą CSid TOKEN_GROUPS strukturę do CTokenGroups obiektu.

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

Parametry

rSid
Obiekt CSid.

dwAttributes
Atrybuty do skojarzenia z obiektem CSid .

rTokenGroups
Struktura TOKEN_GROUPS .

Uwagi

Te metody dodają do obiektu co najmniej jeden CSid obiekt i skojarzone z nimi atrybuty CTokenGroups .

CTokenGroups::CTokenGroups

Konstruktor.

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

Parametry

Rhs
Obiekt CTokenGroups lub struktura TOKEN_GROUPS , z którą należy skonstruować CTokenGroups obiekt.

Uwagi

Obiekt CTokenGroups można opcjonalnie utworzyć przy użyciu TOKEN_GROUPS struktury lub wcześniej zdefiniowanego CTokenGroups obiektu.

CTokenGroups::~CTokenGroups

Destruktora.

virtual ~CTokenGroups() throw();

Uwagi

Destruktor zwalnia wszystkie przydzielone zasoby.

CTokenGroups::D elete

Usuwa atrybuty CSid i skojarzone z nim CTokenGroups z obiektu.

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

Parametry

rSid
Obiekt CSid , dla którego należy usunąć identyfikator zabezpieczeń (SID) i atrybuty.

Wartość zwracana

Zwraca wartość true, jeśli CSid obiekt zostanie usunięty, w przeciwnym razie wartość false.

CTokenGroups::D eleteAll

Usuwa wszystkie CSid obiekty i skojarzone z nimi atrybuty z CTokenGroups obiektu.

void DeleteAll() throw();

CTokenGroups::GetCount

Zwraca liczbę CSid obiektów zawartych w obiekcie CTokenGroups.

UINT GetCount() const throw();

Wartość zwracana

Zwraca liczbę obiektów CSid i skojarzonych z nimi atrybutów zawartych w CTokenGroups obiekcie.

CTokenGroups::GetLength

Zwraca rozmiar CTokenGroup obiektu.

UINT GetLength() const throw();

Uwagi

Zwraca całkowity rozmiar CTokenGroup obiektu w bajtach.

CTokenGroups::GetPTOKEN_GROUPS

Pobiera wskaźnik do TOKEN_GROUPS struktury.

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

Wartość zwracana

Pobiera wskaźnik do struktury TOKEN_GROUPS należącej do obiektu tokenu CTokenGroups dostępu.

CTokenGroups::GetSidsAndAttributes

CSid Pobiera obiekty i (opcjonalnie) atrybuty należące do CTokenGroups obiektu.

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

Parametry

identyfikatory pSid
Wskaźnik do tablicy obiektów CSid .

atrybuty pAttributes
Wskaźnik do tablicy DWORDs. Jeśli ten parametr zostanie pominięty lub ma wartość NULL, atrybuty nie zostaną pobrane.

Uwagi

Ta metoda wylicza wszystkie CSid obiekty zawarte w CTokenGroups obiekcie i umieszcza je oraz (opcjonalnie) flagi atrybutów do obiektów tablicowych.

CTokenGroups::LookupSid

Pobiera atrybuty skojarzone z obiektem CSid .

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

Parametry

rSid
Obiekt CSid .

pdwAttributes
Wskaźnik do DWORD, który będzie akceptował CSid atrybut obiektu. W przypadku pominięcia lub wartości NULL atrybut nie zostanie pobrany.

Wartość zwracana

Zwraca wartość true, jeśli element zostanie znaleziony CSid , w przeciwnym razie wartość false.

Uwagi

Ustawienie wartości pdwAttributes na wartość NULL umożliwia potwierdzenie istnienia CSid atrybutu bez uzyskiwania dostępu do atrybutu. Należy pamiętać, że ta metoda nie powinna być używana do sprawdzania praw dostępu. Zamiast tego aplikacje powinny używać metody CAccessToken::CheckTokenMembership .

CTokenGroups::operator =

Operator przypisania.

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

Parametry

Rhs
Struktura CTokenGroups obiektu lub TOKEN_GROUPS do przypisania do CTokenGroups obiektu.

Wartość zwracana

Zwraca zaktualizowany CTokenGroups obiekt.

CTokenGroups::operator const TOKEN_GROUPS *

Rzutuje wartość na wskaźnik do TOKEN_GROUPS struktury.

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

Uwagi

Rzutuje wartość na wskaźnik do struktury TOKEN_GROUPS .

Zobacz też

Przykład zabezpieczeń
Klasa CSid
Omówienie klasy
Funkcje globalne zabezpieczeń