Classe CTokenGroups

Questa classe è un wrapper per la TOKEN_GROUPS struttura.

Sintassi

class CTokenGroups

Membri

Costruttori pubblici

Metodi pubblici

Operatori pubblici

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