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 retorno
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 retorno
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.