Classe CAutoRevertImpersonation

Questa classe ripristina gli oggetti CAccessToken a uno stato non rappresentato quando esce dall'ambito.

Sintassi

class CAutoRevertImpersonation

Membri

Costruttori pubblici

Metodi 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 NT o Windows 2000. Questi token di accesso possono essere rappresentati con la CAccessToken classe .

A volte è necessario rappresentare i token di accesso. Questa classe viene fornita per praticità, ma non esegue la rappresentazione dei token di accesso; esegue solo la riversione automatica a uno stato non rappresentato. Ciò avviene perché la rappresentazione dell'accesso ai token può essere eseguita in diversi modi.

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

Requisiti

Intestazione: atlsecurity.h

CAutoRevertImpersonation::Attach

Automatizza la riversione della rappresentazione di un token di accesso.

void Attach(const CAccessToken* pAT) throw();

Parametri

buffetto
Indirizzo dell'oggetto CAccessToken da ripristinare automaticamente

Osservazioni:

Questo metodo deve essere utilizzato solo se l'oggetto CAutoRevertImpersonation è stato creato con un puntatore NULL CAccessToken o se Detach è stato chiamato in precedenza. Per casi semplici, non è necessario usare questo metodo.

CAutoRevertImpersonation::CAutoRevertImpersonation

Costruisce un oggetto CAutoRevertImpersonation.

CAutoRevertImpersonation(const CAccessToken* pAT) throw();

Parametri

buffetto
Indirizzo dell'oggetto CAccessToken da ripristinare automaticamente.

Osservazioni:

La rappresentazione effettiva del token di accesso deve essere eseguita separatamente e preferibilmente prima della creazione di un CAutoRevertImpersonation oggetto. Questa rappresentazione verrà ripristinata automaticamente quando l'oggetto esce dall'ambito CAutoRevertImpersonation .

CAutoRevertImpersonation::~CAutoRevertImpersonation

Elimina definitivamente l'oggetto e ripristina la rappresentazione del token di accesso.

~CAutoRevertImpersonation() throw();

Osservazioni:

Ripristina qualsiasi rappresentazione attualmente attiva per l'oggetto CAccessToken fornito in fase di costruzione o tramite il metodo Attach . Se non è associato alcun CAccessToken elemento, il distruttore non ha alcun effetto.

CAutoRevertImpersonation::D etach

Annulla la riversione automatica della rappresentazione.

const CAccessToken* Detach() throw();

Valore restituito

Indirizzo dell'oggetto CAccessToken associato in precedenza o NULL se non esiste alcuna associazione.

Osservazioni:

La chiamata a Detach impedisce all'oggetto CAutoRevertImpersonation di ripristinare qualsiasi rappresentazione attualmente attiva per l'oggetto CAccessToken associato a questo oggetto. CAutoRevertImpersonation può quindi essere eliminato definitivamente senza alcun effetto o riassociato allo stesso oggetto o a un altro CAccessToken oggetto usando Attach.

CAutoRevertImpersonation::GetAccessToken

Recupera il token di accesso corrente associato a questo oggetto.

const CAccessToken* GetAccessToken() throw();

Valore restituito

Indirizzo dell'oggetto CAccessToken associato in precedenza o NULL se non esiste alcuna associazione.

Osservazioni:

Se questo metodo viene chiamato per gli scopi che includono la riversione di una rappresentazione dell'oggetto CAccessToken , è necessario utilizzare invece il metodo Detach .

Vedi anche

Esempio di ATLSecurity
Token di accesso
Cenni preliminari sulla classe