Clase CAutoRevertImpersonation
Esta clase revierte los objetos CAccessToken a un estado no individual fuera del ámbito.
Sintaxis
class CAutoRevertImpersonation
Miembros
Constructores públicos
| Nombre | Descripción |
|---|---|
| CAutoRevertImpersonation::CAutoRevertImpersonation | Construye un objeto CAutoRevertImpersonation |
| CAutoRevertImpersonation::~CAutoRevertImpersonation | Destruye el objeto y revierte la suplantación del token de acceso. |
Métodos públicos
| Nombre | Descripción |
|---|---|
| CAutoRevertImpersonation::Attach | Automatiza la reversión de suplantación de un token de acceso. |
| CAutoRevertImpersonation::Detach | Cancela la reversión automática de suplantación. |
| CAutoRevertImpersonation::GetAccessToken | Recupera el token de acceso actual asociado a este objeto. |
Comentarios
Un token de acceso es un objeto que describe el contexto de seguridad de un proceso o subproceso y que se asigna a cada usuario que ha iniciado sesión en un sistema Windows NT o Windows 2000. Estos tokens de acceso se pueden representar con la clase CAccessToken.
A veces es necesario suplantar los tokens de acceso. Esta clase se proporciona por conveniencia, pero no realiza la suplantación de tokens de acceso; solo realiza la reversión automática a un estado no individual. Esto se debe a que la suplantación de acceso a tokens se puede realizar de diferentes maneras.
Para una introducción al modelo de control de acceso en Windows, consulte Control de acceso en Windows SDK.
Requisitos
Encabezado: atlsecurity.h
CAutoRevertImpersonation::Attach
Automatiza la reversión de suplantación de un token de acceso.
void Attach(const CAccessToken* pAT) throw();
Parámetros
pAT
La dirección del objeto CAccessToken que se va a revertir automáticamente
Comentarios
Este método solo se debe usar si el objeto CAutoRevertImpersonation se creó con un puntero NULL CAccessToken o si se llamó a Desasociar previamente. Para casos sencillos, no es necesario usar este método.
CAutoRevertImpersonation::CAutoRevertImpersonation
Construye un objeto CAutoRevertImpersonation.
CAutoRevertImpersonation(const CAccessToken* pAT) throw();
Parámetros
pAT
Dirección del objeto CAccessToken que se va a revertir automáticamente.
Comentarios
La suplantación real del token de acceso debe realizarse por separado y preferiblemente antes de la creación de un objeto CAutoRevertImpersonation. Esta suplantación se revertirá automáticamente cuando el objetoCAutoRevertImpersonation esté fuera del ámbito.
CAutoRevertImpersonation::~CAutoRevertImpersonation
Destruye el objeto y revierte la suplantación del token de acceso.
~CAutoRevertImpersonation() throw();
Comentarios
Revierte cualquier suplantación que esté en vigor para el objeto CAccessToken proporcionado en la construcción o a través del método Adjuntar. Si CAccessToken no está asociado, el destructor no tiene ningún efecto.
CAutoRevertImpersonation::Detach
Cancela la reversión automática de suplantación.
const CAccessToken* Detach() throw();
Valor devuelto
La dirección del CAccessToken previamente asociado, o NULL si no había ninguna asociación.
Comentarios
Llamar a Desasociar impide que el objeto CAutoRevertImpersonation revierta cualquier suplantación que esté actualmente en vigor para el objeto CAccessToken asociado a este objeto. CAutoRevertImpersonation se puede destruir sin ningún efecto ni volver a asociarse al mismo objeto u otro CAccessToken objeto mediante Adjuntar.
CAutoRevertImpersonation::GetAccessToken
Recupera el token de acceso actual asociado a este objeto.
const CAccessToken* GetAccessToken() throw();
Valor devuelto
La dirección del CAccessToken previamente asociado, o NULL si no había ninguna asociación.
Comentarios
Si se llama a este método para los fines que incluyen la reversión de una suplantación del objeto CAccessToken, se debe usar el método Desasociar en su lugar.
Consulte también
Ejemplo de ATLSecurity
Tokens de acceso
Información general sobre la clase