Classe CTokenGroups

Questa classe è un wrapper per la TOKEN_GROUPS struttura.

Importante

Questa classe e i relativi membri non possono essere usati nelle applicazioni eseguite in Windows Runtime.

Sintassi

class CTokenGroups

Membri

Costruttori pubblici

Nome	Descrizione
CTokenGroups::CTokenGroups	Costruttore.
CTokenGroups::~CTokenGroups	Distruttore.

Metodi pubblici

Nome	Descrizione
CTokenGroups::Add	Aggiunge una CSid struttura o esistente TOKEN_GROUPS all'oggetto CTokenGroups .
CTokenGroups::D elete	Elimina un CSid oggetto e i relativi attributi associati dall'oggetto CTokenGroups .
CTokenGroups::D eleteAll	Elimina tutti gli CSid oggetti e i relativi attributi associati dall'oggetto CTokenGroups .
CTokenGroups::GetCount	Restituisce il numero di CSid oggetti e gli attributi associati contenuti nell'oggetto CTokenGroups .
CTokenGroups::GetLength	Restituisce le dimensioni dell'oggetto CTokenGroups .
CTokenGroups::GetPTOKEN_GROUPS	Recupera un puntatore alla TOKEN_GROUPS struttura.
CTokenGroups::GetSidsAndAttributes	Recupera gli CSid oggetti e gli attributi appartenenti all'oggetto CTokenGroups .
CTokenGroups::LookupSid	Recupera gli attributi associati a un CSid oggetto .

Operatori pubblici

Nome	Descrizione
CTokenGroups::operator const TOKEN_GROUPS *	Esegue il cast dell'oggetto CTokenGroups a un puntatore alla TOKEN_GROUPS struttura.
CTokenGroups::operator =	Operatore di assegnazione.

Osservazioni:

Un token di accesso è un oggetto che descrive il contesto di sicurezza di un processo o di un thread e viene allocato a ogni utente connesso a un sistema Windows.

La CTokenGroups classe è un wrapper per la struttura TOKEN_GROUPS , contenente informazioni sugli identificatori di sicurezza del gruppo (SID) in un token di accesso.

Per un'introduzione al modello di controllo di accesso in Windows, vedere Controllo di accesso in Windows SDK.

Requisiti

Intestazione: atlsecurity.h

CTokenGroups::Add

Aggiunge una CSid struttura o esistente TOKEN_GROUPS all'oggetto CTokenGroups .

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

Parametri

rSid
Oggetto CSid .

dwAttributes
Attributi da associare all'oggetto CSid .

rTokenGroups
Struttura TOKEN_GROUPS .

Osservazioni:

Questi metodi aggiungono uno o più CSid oggetti e i relativi attributi associati all'oggetto CTokenGroups .

CTokenGroups::CTokenGroups

Costruttore.

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

Parametri

rhs
Oggetto CTokenGroups o struttura TOKEN_GROUPS con cui costruire l'oggetto CTokenGroups .

Osservazioni:

L'oggetto CTokenGroups può essere creato facoltativamente utilizzando una TOKEN_GROUPS struttura o un oggetto definito CTokenGroups in precedenza.

CTokenGroups::~CTokenGroups

Distruttore.

virtual ~CTokenGroups() throw();

Osservazioni:

Il distruttore libera tutte le risorse allocate.

CTokenGroups::D elete

Elimina un CSid oggetto e i relativi attributi associati dall'oggetto CTokenGroups .

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

Parametri

rSid
Oggetto CSid per il quale devono essere rimossi l'identificatore di sicurezza (SID) e gli attributi.

Valore restituito

Restituisce true se l'oggetto CSid viene rimosso, false in caso contrario.

CTokenGroups::D eleteAll

Elimina tutti gli CSid oggetti e i relativi attributi associati dall'oggetto CTokenGroups .

void DeleteAll() throw();

CTokenGroups::GetCount

Restituisce il numero di CSid oggetti contenuti in CTokenGroups.

UINT GetCount() const throw();

Valore restituito

Restituisce il numero di oggetti CSid e i relativi attributi associati contenuti nell'oggetto CTokenGroups .

CTokenGroups::GetLength

Restituisce le dimensioni dell'oggetto CTokenGroup .

UINT GetLength() const throw();

Osservazioni:

Restituisce la dimensione totale dell'oggetto CTokenGroup , espressa in byte.

CTokenGroups::GetPTOKEN_GROUPS

Recupera un puntatore alla TOKEN_GROUPS struttura.

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

Valore restituito

Recupera un puntatore alla struttura TOKEN_GROUPS appartenente all'oggetto CTokenGroups token di accesso.

CTokenGroups::GetSidsAndAttributes

Recupera gli CSid oggetti e (facoltativamente) gli attributi appartenenti all'oggetto CTokenGroups .

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

Parametri

pSids
Puntatore a una matrice di oggetti CSid .

pAttributes
Puntatore a una matrice di DWORD. Se questo parametro viene omesso o NULL, gli attributi non vengono recuperati.

Osservazioni:

Questo metodo enumererà tutti gli CSid oggetti contenuti nell'oggetto CTokenGroups e li inserisce e (facoltativamente) i flag di attributo in oggetti matrice.

CTokenGroups::LookupSid

Recupera gli attributi associati a un CSid oggetto .

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

Parametri

rSid
Oggetto CSid .

pdwAttributes
Puntatore a un DWORD che accetterà l'attributo CSid dell'oggetto. Se omesso o NULL, l'attributo non verrà recuperato.

Valore restituito

Restituisce true se viene CSid trovato, false in caso contrario.

Osservazioni:

L'impostazione di pdwAttributes su NULL consente di confermare l'esistenza di CSid senza accedere all'attributo. Si noti che questo metodo non deve essere usato per controllare i diritti di accesso. Le applicazioni devono invece usare il metodo CAccessToken::CheckTokenMembership .

CTokenGroups::operator =

Operatore di assegnazione.

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

Parametri

rhs
Struttura CTokenGroups dell'oggetto o TOKEN_GROUPS da assegnare all'oggetto CTokenGroups .

Valore restituito

Restituisce l'oggetto aggiornato CTokenGroups .

CTokenGroups::operator const TOKEN_GROUPS *

Esegue il cast di un valore a un puntatore alla TOKEN_GROUPS struttura.

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

Osservazioni:

Esegue il cast di un valore a un puntatore alla struttura TOKEN_GROUPS .

Vedi anche

Esempio di sicurezza
Classe CSid
Cenni preliminari sulla classe
Funzioni globali di sicurezza