Classe CAutoRevertImpersonation

Essa classe reverte objetos CAccessToken para um estado de não representação quando ele sai do escopo.

Sintaxe

class CAutoRevertImpersonation

Membros

Construtores públicos

Nome	Descrição
CAutoRevertImpersonation::CAutoRevertImpersonation	Constrói um objeto CAutoRevertImpersonation
CAutoRevertImpersonation::~CAutoRevertImpersonation	Destrói o objeto e reverte a representação do token de acesso.

Métodos públicos

Nome	Descrição
CAutoRevertImpersonation::Attach	Automatiza a reversão de representação de um token de acesso.
CAutoRevertImpersonation::Detach	Cancela a reversão de representação automática.
CAutoRevertImpersonation::GetAccessToken	Recupera o token de acesso atual associado a esse objeto.

Comentários

Um token de acesso é um objeto que descreve o contexto de segurança de um processo ou thread e é alocado para cada usuário conectado a um sistema Windows NT ou Windows 2000. Esses tokens de acesso podem ser representados com a classe CAccessToken.

Às vezes, é necessário representar tokens de acesso. Essa classe é fornecida como uma conveniência, mas não executa a representação de tokens de acesso, ele executa apenas a reversão automática para um estado não representado. Isso ocorre porque a representação de acesso ao token pode ser executada de várias maneiras diferentes.

Para ver uma introdução ao modelo de controle de acesso no Windows, confira Controle de Acesso no SDK do Windows.

Requisitos

Cabeçalho: atlsecurity.h

CAutoRevertImpersonation::Attach

Automatiza a reversão de representação de um token de acesso.

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

Parâmetros

pAT
O endereço do objeto CAccessToken a ser revertido automaticamente

Comentários

Esse método só deve ser usado se o objeto CAutoRevertImpersonation foi criado com um ponteiro NULL CAccessToken ou se Desanexar foi chamado anteriormente. Para casos simples, não é necessário usar esse método.

CAutoRevertImpersonation::CAutoRevertImpersonation

Constrói um objeto CAutoRevertImpersonation.

CAutoRevertImpersonation(const CAccessToken* pAT) throw();

Parâmetros

pAT
O endereço do objeto CAccessToken a ser revertido automaticamente.

Comentários

A representação real do token de acesso deve ser executada separadamente e preferencialmente antes da criação de um objeto CAutoRevertImpersonation. Essa representação será revertida automaticamente quando o objeto CAutoRevertImpersonation sair do escopo.

CAutoRevertImpersonation::~CAutoRevertImpersonation

Destrói o objeto e reverte a representação do token de acesso.

~CAutoRevertImpersonation() throw();

Comentários

Reverte qualquer representação atualmente em vigor para o objeto CAccessToken fornecido na construção ou por meio do método Anexar. Se não CAccessToken estiver associado, o destruidor não terá efeito.

CAutoRevertImpersonation::Detach

Cancela a reversão de representação automática.

const CAccessToken* Detach() throw();

Valor de Devolução

O endereço do CAccessToken anteriormente associado ou NULL se nenhuma associação existir.

Comentários

Chamar Desanexar impede que o objeto CAutoRevertImpersonation reverta qualquer representação atualmente em vigor para o objeto CAccessToken associado a esse objeto. CAutoRevertImpersonation pode então ser destruído sem nenhum efeito ou reassociado ao mesmo ou a outro objeto CAccessToken usando Anexar.

CAutoRevertImpersonation::GetAccessToken

Recupera o token de acesso atual associado a esse objeto.

const CAccessToken* GetAccessToken() throw();

Valor de Devolução

O endereço do CAccessToken anteriormente associado ou NULL se nenhuma associação existir.

Comentários

Se esse método for chamado para as finalidades que incluem a reversão de uma representação do objeto CAccessToken, o método Desanexar deverá ser usado em vez disso.

Confira também

Exemplo de ATLSecurity
Tokens de acesso
Visão geral da classe