Klasa CAutoRevertImpersonation

Ta klasa przywraca obiekty CAccessToken do stanu innego niż personimating, gdy wykracza poza zakres.

Składnia

class CAutoRevertImpersonation

Elementy członkowskie

Konstruktory publiczne

Metody publiczne

Uwagi

Token dostępu to obiekt, który opisuje kontekst zabezpieczeń procesu lub wątku i jest przydzielany każdemu użytkownikowi zalogowanego w systemie Windows NT lub Windows 2000. Te tokeny dostępu mogą być reprezentowane za pomocą CAccessToken klasy .

Czasami konieczne jest personifikacja tokenów dostępu. Ta klasa jest udostępniana jako wygoda, ale nie wykonuje personifikacji tokenów dostępu; wykonuje tylko automatyczną rewersję do stanu niezpersonifikowanego. Dzieje się tak, ponieważ personifikacja dostępu do tokenu może być wykonywana na kilka różnych sposobów.

Aby zapoznać się z wprowadzeniem do modelu kontroli dostępu w systemie Windows, zobacz Kontrola dostępu w zestawie Windows SDK.

Wymagania

Nagłówek: atlsecurity.h

CAutoRevertImpersonation::Attach

Automatyzuje rewersję personifikacji tokenu dostępu.

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

Parametry

klepać
Adres obiektu CAccessToken , który ma zostać przywrócony automatycznie

Uwagi

Ta metoda powinna być używana tylko wtedy, gdy obiekt CAutoRevertImpersonation został utworzony ze wskaźnikiem NULL CAccessToken lub jeśli wcześniej wywołano polecenie Detach. W prostych przypadkach nie jest konieczne użycie tej metody.

CAutoRevertImpersonation::CAutoRevertImpersonation

CAutoRevertImpersonation Tworzy obiekt.

CAutoRevertImpersonation(const CAccessToken* pAT) throw();

Parametry

klepać
Adres obiektu CAccessToken , który ma zostać przywrócony automatycznie.

Uwagi

Rzeczywiste personifikacja tokenu dostępu należy wykonać oddzielnie od i najlepiej przed utworzeniem CAutoRevertImpersonation obiektu. Personifikacja zostanie przywrócona automatycznie, gdy CAutoRevertImpersonation obiekt wykracza poza zakres.

CAutoRevertImpersonation::~CAutoRevertImpersonation

Niszczy obiekt i przywraca personifikację tokenu dostępu.

~CAutoRevertImpersonation() throw();

Uwagi

Przywraca wszelkie personifikacje aktualnie w przypadku obiektu CAccessToken dostarczonego w budowie lub za pomocą metody Attach. Jeśli nie CAccessToken jest skojarzony, destruktor nie ma żadnego efektu.

CAutoRevertImpersonation::D etach

Anuluje automatyczną rewersję personifikacji.

const CAccessToken* Detach() throw();

Wartość zwracana

Adres wcześniej skojarzonego tokenu CAccessToken lub null, jeśli nie istniało żadne skojarzenie.

Uwagi

Wywołanie metody Detach uniemożliwia CAutoRevertImpersonation obiektowi przywrócenie wszelkich personifikacji aktualnie w przypadku obiektu CAccessToken skojarzonego z tym obiektem. CAutoRevertImpersonation Następnie można zniszczyć bez żadnego efektu lub ponownie skojarzyć z tym samym lub innym CAccessToken obiektem przy użyciu polecenia Attach.

CAutoRevertImpersonation::GetAccessToken

Pobiera token dostępu skojarzony z tym obiektem.

const CAccessToken* GetAccessToken() throw();

Wartość zwracana

Adres wcześniej skojarzonego tokenu CAccessToken lub null, jeśli nie istniało żadne skojarzenie.

Uwagi

Jeśli ta metoda jest wywoływana w celach obejmujących rewersję personifikacji CAccessToken obiektu, należy zamiast tego użyć metody Detach .

Zobacz też

Przykład ATLSecurity
Tokeny dostępu
Omówienie klasy