CAutoRevertImpersonation, classe

Cette classe rétablit les objets CAccessToken à un état non emprunt d’identité lorsqu’il sort de l’étendue.

Syntaxe

class CAutoRevertImpersonation

Membres

Constructeurs publics

Nom	Description
CAutoRevertImpersonation ::CAutoRevertImpersonation	Construit un CAutoRevertImpersonation objet
CAutoRevertImpersonation ::~CAutoRevertImpersonation	Détruit l’objet et rétablit l’emprunt d’identité du jeton d’accès.

Méthodes publiques

Nom	Description
CAutoRevertImpersonation ::Attach	Automatise la réversion d’emprunt d’identité d’un jeton d’accès.
CAutoRevertImpersonation ::D etach	Annule la réversion automatique de l’emprunt d’identité.
CAutoRevertImpersonation ::GetAccessToken	Récupère le jeton d’accès actuel associé à cet objet.

Notes

Un jeton d’accès est un objet qui décrit le contexte de sécurité d’un processus ou d’un thread et qui est alloué à chaque utilisateur connecté à un système Windows NT ou Windows 2000. Ces jetons d’accès peuvent être représentés avec la CAccessToken classe.

Il est parfois nécessaire d’emprunter l’identité des jetons d’accès. Cette classe est fournie de manière pratique, mais elle n’effectue pas l’emprunt d’identité des jetons d’accès ; elle effectue uniquement la réversion automatique vers un état nonpersonné. Cela est dû au fait que l’emprunt d’identité d’accès au jeton peut être effectué de plusieurs façons différentes.

Pour une présentation du modèle de contrôle d’accès dans Windows, consultez Contrôle d’accès dans le Kit de développement logiciel (SDK) Windows.

Spécifications

En-tête : atlsecurity.h

CAutoRevertImpersonation ::Attach

Automatise la réversion d’emprunt d’identité d’un jeton d’accès.

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

Paramètres

Pat
Adresse de l’objet CAccessToken à rétablir automatiquement

Notes

Cette méthode ne doit être utilisée que si l’objet CAutoRevertImpersonation a été créé avec un pointeur NULL CAccessToken ou si Detach a été appelé précédemment. Pour les cas simples, il n’est pas nécessaire d’utiliser cette méthode.

CAutoRevertImpersonation ::CAutoRevertImpersonation

Construit un objet CAutoRevertImpersonation.

CAutoRevertImpersonation(const CAccessToken* pAT) throw();

Paramètres

Pat
Adresse de l’objet CAccessToken à rétablir automatiquement.

Notes

L’emprunt d’identité réel du jeton d’accès doit être effectué séparément et de préférence avant la création d’un CAutoRevertImpersonation objet. Cet emprunt d’identité est rétabli automatiquement lorsque l’objet CAutoRevertImpersonation sort de l’étendue.

CAutoRevertImpersonation ::~CAutoRevertImpersonation

Détruit l’objet et rétablit l’emprunt d’identité du jeton d’accès.

~CAutoRevertImpersonation() throw();

Notes

Rétablit l’emprunt d’identité actuellement en vigueur pour l’objet CAccessToken fourni au moment de la construction ou via la méthode Attach . Si aucun n’est CAccessToken associé, le destructeur n’a aucun effet.

CAutoRevertImpersonation ::D etach

Annule la réversion automatique de l’emprunt d’identité.

const CAccessToken* Detach() throw();

Valeur de retour

Adresse du CAccessToken précédemment associé ou NULL si aucune association n’existait.

Notes

L’appel de Detach empêche l’objet CAutoRevertImpersonation de rétablir l’emprunt d’identité actuellement en vigueur pour l’objet CAccessToken associé à cet objet. CAutoRevertImpersonationpeut ensuite être détruit sans effet ou réassocié au même objet ou à un autre CAccessToken objet à l’aide d’Attach.

CAutoRevertImpersonation ::GetAccessToken

Récupère le jeton d’accès actuel associé à cet objet.

const CAccessToken* GetAccessToken() throw();

Valeur de retour

Adresse du CAccessToken précédemment associé ou NULL si aucune association n’existait.

Notes

Si cette méthode est appelée à des fins qui incluent la réversion d’un emprunt d’identité de l’objet, la méthode Detach doit être utilisée à la CAccessToken place.

Voir aussi

Exemple ATLSecurity
Jetons d’accès
Vue d’ensemble de la classe