CAccessToken-Klasse
Diese Klasse ist ein Wrapper für ein Zugriffstoken.
Wichtig
Diese Klasse und ihre Member können nicht in Anwendungen verwendet werden, die in der Windows-Runtime ausgeführt werden.
Syntax
class CAccessToken
Member
Öffentliche Konstruktoren
| Name | Beschreibung |
|---|---|
| CAccessToken::~CAccessToken | Der Destruktor. |
Öffentliche Methoden
| Name | Beschreibung |
|---|---|
| CAccessToken::Attach | Rufen Sie diese Methode auf, um den Besitz des angegebenen Zugriffstokenhandles zu übernehmen. |
| CAccessToken::CheckTokenMembership | Rufen Sie diese Methode auf, um festzustellen, ob eine angegebene SID im CAccessToken Objekt aktiviert ist. |
| CAccessToken::CreateImpersonationToken | Rufen Sie diese Methode auf, um ein neues Identitätswechselzugriffstoken zu erstellen. |
| CAccessToken::CreatePrimaryToken | Rufen Sie diese Methode auf, um ein neues primäres Token zu erstellen. |
| CAccessToken::CreateProcessAsUser | Rufen Sie diese Methode auf, um einen neuen Prozess zu erstellen, der im Sicherheitskontext des benutzers ausgeführt wird, der durch das CAccessToken Objekt dargestellt wird. |
| CAccessToken::CreateRestrictedToken | Rufen Sie diese Methode auf, um ein neues, eingeschränktes CAccessToken Objekt zu erstellen. |
| CAccessToken::D etach | Rufen Sie diese Methode auf, um den Besitz des Zugriffstokens zu widerrufen. |
| CAccessToken::D isablePrivilege | Rufen Sie diese Methode auf, um eine Berechtigung im CAccessToken Objekt zu deaktivieren. |
| CAccessToken::D isablePrivileges | Rufen Sie diese Methode auf, um ein oder mehrere Berechtigungen im CAccessToken Objekt zu deaktivieren. |
| CAccessToken::EnablePrivilege | Rufen Sie diese Methode auf, um ein Privileg im CAccessToken Objekt zu aktivieren. |
| CAccessToken::EnablePrivileges | Rufen Sie diese Methode auf, um ein oder mehrere Berechtigungen im CAccessToken Objekt zu aktivieren. |
| CAccessToken::GetDefaultDacl | Rufen Sie diese Methode auf, um die standardmäßige DACL des CAccessToken Objekts zurückzugeben. |
| CAccessToken::GetEffectiveToken | Rufen Sie diese Methode auf, um das Objekt abzurufen, das CAccessToken dem Zugriffstoken entspricht, das für den aktuellen Thread wirksam ist. |
| CAccessToken::GetGroups | Rufen Sie diese Methode auf, um die Tokengruppen des CAccessToken Objekts zurückzugeben. |
| CAccessToken::GetHandle | Rufen Sie diese Methode auf, um ein Handle für das Zugriffstoken abzurufen. |
| CAccessToken::GetImpersonationLevel | Rufen Sie diese Methode auf, um die Identitätswechselebene aus dem Zugriffstoken abzurufen. |
| CAccessToken::GetLogonSessionId | Rufen Sie diese Methode auf, um die dem Objekt zugeordnete CAccessToken Anmeldesitzungs-ID abzurufen. |
| CAccessToken::GetLogonSid | Rufen Sie diese Methode auf, um die dem Objekt zugeordnete CAccessToken Anmelde-SID abzurufen. |
| CAccessToken::GetOwner | Rufen Sie diese Methode auf, um den besitzer abzurufen, der dem CAccessToken Objekt zugeordnet ist. |
| CAccessToken::GetPrimaryGroup | Rufen Sie diese Methode auf, um die primäre Gruppe abzurufen, die dem CAccessToken Objekt zugeordnet ist. |
| CAccessToken::GetPrivileges | Rufen Sie diese Methode auf, um die berechtigungen abzurufen, die dem CAccessToken Objekt zugeordnet sind. |
| CAccessToken::GetProcessToken | Rufen Sie diese Methode auf, um CAccessToken mit dem Zugriffstoken aus einem Prozess zu initialisieren. |
| CAccessToken::GetProfile | Rufen Sie diese Methode auf, um das Handle abzurufen, das auf das Benutzerprofil verweist, das dem CAccessToken Objekt zugeordnet ist. |
| CAccessToken::GetSource | Rufen Sie diese Methode auf, um die Quelle des CAccessToken Objekts abzurufen. |
| CAccessToken::GetStatistics | Rufen Sie diese Methode auf, um Informationen abzurufen, die dem CAccessToken Objekt zugeordnet sind. |
| CAccessToken::GetTerminalServicesSessionId | Rufen Sie diese Methode auf, um die Sitzungs-ID der Terminaldienste abzurufen, die dem CAccessToken Objekt zugeordnet ist. |
| CAccessToken::GetThreadToken | Rufen Sie diese Methode auf, um das CAccessToken Token aus dem angegebenen Thread zu initialisieren. |
| CAccessToken::GetTokenId | Rufen Sie diese Methode auf, um die dem Objekt zugeordnete CAccessToken Token-ID abzurufen. |
| CAccessToken::GetType | Rufen Sie diese Methode auf, um den Tokentyp des CAccessToken Objekts abzurufen. |
| CAccessToken::GetUser | Rufen Sie diese Methode auf, um den benutzer zu identifizieren, der dem CAccessToken Objekt zugeordnet ist. |
| CAccessToken::HKeyCurrentUser | Rufen Sie diese Methode auf, um das Handle abzurufen, das auf das Benutzerprofil verweist, das dem CAccessToken Objekt zugeordnet ist. |
| CAccessToken::Identitätswechsel | Rufen Sie diese Methode auf, um einem Thread einen Identitätswechsel CAccessToken zuzuweisen. |
| CAccessToken::ImpersonateLoggedOnUser | Rufen Sie diese Methode auf, damit der aufrufende Thread den Sicherheitskontext eines angemeldeten Benutzers annehmen kann. |
| CAccessToken::IsTokenRestricted | Rufen Sie diese Methode auf, um zu testen, ob das CAccessToken Objekt eine Liste eingeschränkter SIDs enthält. |
| CAccessToken::LoadUserProfile | Rufen Sie diese Methode auf, um das dem Objekt zugeordnete CAccessToken Benutzerprofil zu laden. |
| CAccessToken::LogonUser | Rufen Sie diese Methode auf, um eine Anmeldesitzung für den Benutzer zu erstellen, der den angegebenen Anmeldeinformationen zugeordnet ist. |
| CAccessToken::OpenCOMClientToken | Rufen Sie diese Methode von einem COM-Server auf, der einen Aufruf eines Clients verarbeitet, um das CAccessToken Zugriffstoken vom COM-Client zu initialisieren. |
| CAccessToken::OpenNamedPipeClientToken | Rufen Sie diese Methode von einem Server auf, der Anforderungen über eine benannte Pipe übernimmt, um das CAccessToken Zugriffstoken vom Client zu initialisieren. |
| CAccessToken::OpenRPCClientToken | Rufen Sie diese Methode von einem Server auf, der einen Aufruf eines RPC-Clients verarbeitet, um das CAccessToken Zugriffstoken vom Client zu initialisieren. |
| CAccessToken::OpenThreadToken | Rufen Sie diese Methode auf, um die Identitätswechselebene festzulegen und dann das CAccessToken Token aus dem angegebenen Thread zu initialisieren. |
| CAccessToken::P rivilegeCheck | Rufen Sie diese Methode auf, um zu bestimmen, ob eine bestimmte Gruppe von Berechtigungen im CAccessToken Objekt aktiviert ist. |
| CAccessToken::Revert | Rufen Sie diese Methode auf, um einen Thread zu beenden, der ein Identitätswechseltoken verwendet. |
| CAccessToken::SetDefaultDacl | Rufen Sie diese Methode auf, um die standardmäßige DACL des CAccessToken Objekts festzulegen. |
| CAccessToken::SetOwner | Rufen Sie diese Methode auf, um den Besitzer des CAccessToken Objekts festzulegen. |
| CAccessToken::SetPrimaryGroup | Rufen Sie diese Methode auf, um die primäre Gruppe des CAccessToken Objekts festzulegen. |
Hinweise
Ein Zugriffstoken ist ein Objekt, das den Sicherheitskontext eines Prozesses oder Threads beschreibt und jedem Benutzer zugewiesen wird, der bei einem Windows-System angemeldet ist.
Eine Einführung in das Zugriffssteuerungsmodell in Windows finden Sie unter Access Control im Windows SDK.
Anforderungen
Kopfzeile: atlsecurity.h
CAccessToken::Attach
Rufen Sie diese Methode auf, um den Besitz des angegebenen Zugriffstokenhandles zu übernehmen.
void Attach(HANDLE hToken) throw();
Parameter
hToken
Ein Handle für das Zugriffstoken.
Hinweise
In Debugbuilds tritt ein Assertionsfehler auf, wenn das CAccessToken Objekt bereits über den Besitz eines Zugriffstokens verfügt.
CAccessToken::~CAccessToken
Der Destruktor.
virtual ~CAccessToken() throw();
Hinweise
Gibt alle zugeordneten Ressourcen frei.
CAccessToken::CheckTokenMembership
Rufen Sie diese Methode auf, um festzustellen, ob eine angegebene SID im CAccessToken Objekt aktiviert ist.
bool CheckTokenMembership(
const CSid& rSid,
bool* pbIsMember) const throw(...);
Parameter
rSid
Verweisen auf ein CSid Class-Objekt .
pbIsMember
Zeigen Sie auf eine Variable, die die Ergebnisse der Prüfung empfängt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die CheckTokenMembership Methode überprüft das Vorhandensein der SID in den Benutzer- und Gruppen-SIDs des Zugriffstokens. Wenn die SID vorhanden ist und das attribut SE_GROUP_ENABLED hat, wird PbIsMember auf TRUE festgelegt. Andernfalls wird sie auf FALSE festgelegt.
In Debugbuilds tritt ein Assertionsfehler auf, wenn pbIsMember kein gültiger Zeiger ist.
Hinweis
Das CAccessToken Objekt muss ein Identitätswechseltoken und kein primäres Token sein.
CAccessToken::CreateImpersonationToken
Rufen Sie diese Methode auf, um ein Identitätswechselzugriffstoken zu erstellen.
bool CreateImpersonationToken(
CAccessToken* pImp,
SECURITY_IMPERSONATION_LEVEL sil = SecurityImpersonation) const throw(...);
Parameter
Pimp
Zeigen Sie auf das neue CAccessToken Objekt.
sil
Gibt einen SECURITY_IMPERSONATION_LEVEL aufgezählten Typ an, der die Identitätswechselebene des neuen Tokens bereitstellt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
CreateImpersonationToken ruft DuplicateToken auf, um ein neues Identitätswechseltoken zu erstellen.
CAccessToken::CreatePrimaryToken
Rufen Sie diese Methode auf, um ein neues primäres Token zu erstellen.
bool CreatePrimaryToken(
CAccessToken* pPri,
DWORD dwDesiredAccess = MAXIMUM_ALLOWED,
const CSecurityAttributes* pTokenAttributes = NULL) const throw(...);
Parameter
pPri
Zeigen Sie auf das neue CAccessToken Objekt.
dwDesiredAccess
Gibt die angeforderten Zugriffsrechte für das neue Token an. Standardmäßig fordert MAXIMUM_ALLOWED alle Für den Anrufer gültigen Zugriffsrechte an. Weitere Informationen zu Zugriffsrechten finden Sie unter Zugriffsberechtigungen und Zugriffsmasken .
pTokenAttributes
Zeiger auf eine SECURITY_ATTRIBUTES-Struktur , die einen Sicherheitsdeskriptor für das neue Token angibt und bestimmt, ob untergeordnete Prozesse das Token erben können. Wenn pTokenAttributes NULL ist, erhält das Token einen Standardsicherheitsdeskriptor, und der Handle kann nicht geerbt werden.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
CreatePrimaryToken ruft DuplicateTokenEx auf, um ein neues primäres Token zu erstellen.
CAccessToken::CreateProcessAsUser
Rufen Sie diese Methode auf, um einen neuen Prozess zu erstellen, der im Sicherheitskontext des benutzers ausgeführt wird, der durch das CAccessToken Objekt dargestellt wird.
bool CreateProcessAsUser(
LPCTSTR pApplicationName,
LPTSTR pCommandLine,
LPPROCESS_INFORMATION pProcessInformation,
LPSTARTUPINFO pStartupInfo,
DWORD dwCreationFlags = NORMAL_PRIORITY_CLASS,
bool bLoadProfile = false,
const CSecurityAttributes* pProcessAttributes = NULL,
const CSecurityAttributes* pThreadAttributes = NULL,
bool bInherit = false,
LPCTSTR pCurrentDirectory = NULL) throw();
Parameter
pApplicationName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die das auszuführende Modul angibt. Dieser Parameter darf nicht NULL sein.
pCommandLine
Zeiger auf eine mit Null beendete Zeichenfolge, die die auszuführende Befehlszeile angibt.
pProcessInformation
Zeigen Sie auf eine PROCESS_INFORMATION Struktur , die Identifikationsinformationen zum neuen Prozess empfängt.
pStartupInfo
Zeiger auf eine STARTUPINFO-Struktur, die angibt, wie das Standard Fenster für den neuen Prozess angezeigt werden soll.
dwCreationFlags
Gibt zusätzliche Flags an, die die Prioritätsklasse und die Erstellung des Prozesses steuern. Eine Liste der Flags finden Sie in der Win32-Funktion CreateProcessAsUser .
bLoadProfile
Wenn TRUE, wird das Profil des Benutzers mit LoadUserProfile geladen.
pProcessAttributes
Zeiger auf eine SECURITY_ATTRIBUTES-Struktur , die einen Sicherheitsdeskriptor für den neuen Prozess angibt und bestimmt, ob untergeordnete Prozesse den zurückgegebenen Handle erben können. Wenn pProcessAttributes NULL ist, ruft der Prozess einen Standardsicherheitsdeskriptor ab, und der Handle kann nicht geerbt werden.
pThreadAttributes
Zeiger auf eine SECURITY_ATTRIBUTES-Struktur , die einen Sicherheitsdeskriptor für den neuen Thread angibt, und bestimmt, ob untergeordnete Prozesse den zurückgegebenen Handle erben können. Wenn pThreadAttributes NULL ist, erhält der Thread einen Standardsicherheitsdeskriptor, und der Handle kann nicht geerbt werden.
bInherit
Gibt an, ob der neue Prozess Handles vom aufrufenden Prozess erbt. Wenn WAHR, wird jedes vererbbare offene Handle im aufrufenden Prozess vom neuen Prozess geerbt. Geerbte Handles weisen denselben Wert und zugriffsberechtigungen wie die ursprünglichen Handles auf.
pCurrentDirectory
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die das aktuelle Laufwerk und verzeichnis für den neuen Prozess angibt. Die Zeichenfolge muss ein vollständiger Pfad sein, der einen Laufwerkbuchstaben enthält. Wenn dieser Parameter NULL ist, verwendet der neue Prozess dasselbe aktuelle Laufwerk und Verzeichnis wie der aufrufende Prozess.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
CreateProcessAsUser verwendet die CreateProcessAsUser Win32-Funktion, um einen neuen Prozess zu erstellen, der im Sicherheitskontext des durch das CAccessToken Objekt dargestellten Benutzers ausgeführt wird. Eine vollständige Erläuterung der erforderlichen Parameter finden Sie in der Beschreibung der CreateProcessAsUser-Funktion .
Damit diese Methode erfolgreich ausgeführt werden kann, muss das CAccessToken Objekt AssignPrimaryToken (es sei denn, es ist ein eingeschränktes Token) und die Rechte "IncreaseQuota" enthalten.
CAccessToken::CreateRestrictedToken
Rufen Sie diese Methode auf, um ein neues, eingeschränktes CAccessToken Objekt zu erstellen.
bool CreateRestrictedToken(
CAccessToken* pRestrictedToken,
const CTokenGroups& SidsToDisable,
const CTokenGroups& SidsToRestrict,
const CTokenPrivileges& PrivilegesToDelete = CTokenPrivileges()) const throw(...);
Parameter
pRestrictedToken
Das neue, eingeschränkte CAccessToken Objekt.
SidsToDisable
Ein CTokenGroups Objekt, das die nur deny-only-SIDs angibt.
SidsToRestrict
Ein CTokenGroups Objekt, das die einschränkenden SIDs angibt.
PrivilegesToDelete
Ein CTokenPrivileges Objekt, das die Berechtigungen angibt, die im eingeschränkten Token gelöscht werden sollen. Der Standardwert erstellt ein leeres Objekt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
CreateRestrictedToken verwendet die CreateRestrictedToken Win32-Funktion, um ein neues CAccessToken Objekt mit Einschränkungen zu erstellen.
Wichtig
Stellen Sie bei Verwendung CreateRestrictedTokenfolgendes sicher: Das vorhandene Token ist gültig (und nicht vom Benutzer eingegeben) und SidsToDisable und PrivilegesToDelete sind beide gültig (und nicht vom Benutzer eingegeben). Wenn die Methode FALSE zurückgibt, verweigern Sie die Funktionalität.
CAccessToken::D etach
Rufen Sie diese Methode auf, um den Besitz des Zugriffstokens zu widerrufen.
HANDLE Detach() throw();
Rückgabewert
Gibt den Ziehpunkt zurück, der CAccessToken getrennt wurde.
Hinweise
Diese Methode widerruft den CAccessTokenBesitz des Zugriffstokens.
CAccessToken::D isablePrivilege
Rufen Sie diese Methode auf, um eine Berechtigung im CAccessToken Objekt zu deaktivieren.
bool DisablePrivilege(
LPCTSTR pszPrivilege,
CTokenPrivileges* pPreviousState = NULL) throw(...);
Parameter
pszPrivilege
Zeigen Sie auf eine Zeichenfolge, die die Berechtigung zum Deaktivieren im CAccessToken Objekt enthält.
pPreviousState
Zeigen Sie auf ein CTokenPrivileges Objekt, das den vorherigen Status der Berechtigungen enthält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::D isablePrivileges
Rufen Sie diese Methode auf, um ein oder mehrere Berechtigungen im CAccessToken Objekt zu deaktivieren.
bool DisablePrivileges(
const CAtlArray<LPCTSTR>& rPrivileges,
CTokenPrivileges* pPreviousState = NULL) throw(...);
Parameter
rPrivileges
Zeigen Sie auf ein Array von Zeichenfolgen, die die Berechtigungen zum Deaktivieren im CAccessToken Objekt enthalten.
pPreviousState
Zeigen Sie auf ein CTokenPrivileges Objekt, das den vorherigen Status der Berechtigungen enthält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::EnablePrivilege
Rufen Sie diese Methode auf, um ein Privileg im CAccessToken Objekt zu aktivieren.
bool EnablePrivilege(
LPCTSTR pszPrivilege,
CTokenPrivileges* pPreviousState = NULL) throw(...);
Parameter
pszPrivilege
Zeigen Sie auf eine Zeichenfolge, die die Im Objekt zu aktivierenden CAccessToken Berechtigungen enthält.
pPreviousState
Zeigen Sie auf ein CTokenPrivileges Objekt, das den vorherigen Status der Berechtigungen enthält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::EnablePrivileges
Rufen Sie diese Methode auf, um ein oder mehrere Berechtigungen im CAccessToken Objekt zu aktivieren.
bool EnablePrivileges(
const CAtlArray<LPCTSTR>& rPrivileges,
CTokenPrivileges* pPreviousState = NULL) throw(...);
Parameter
rPrivileges
Zeigen Sie auf ein Array von Zeichenfolgen, die die Berechtigungen enthalten, die CAccessToken im Objekt aktiviert werden sollen.
pPreviousState
Zeigen Sie auf ein CTokenPrivileges Objekt, das den vorherigen Status der Berechtigungen enthält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetDefaultDacl
Rufen Sie diese Methode auf, um die standardmäßige DACL des CAccessToken Objekts zurückzugeben.
bool GetDefaultDacl(CDacl* pDacl) const throw(...);
Parameter
pDacl
Zeiger auf das CDacl Class-Objekt , das die Standardmäßig-DACL des CAccessToken Objekts empfängt.
Rückgabewert
Gibt TRUE zurück, wenn die standardmäßige DACL wiederhergestellt wurde, andernfalls FALSE.
CAccessToken::GetEffectiveToken
Rufen Sie diese Methode auf, um das Objekt abzurufen, das CAccessToken dem Zugriffstoken entspricht, das für den aktuellen Thread wirksam ist.
bool GetEffectiveToken(DWORD dwDesiredAccess) throw();
Parameter
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetGroups
Rufen Sie diese Methode auf, um die Tokengruppen des CAccessToken Objekts zurückzugeben.
bool GetGroups(CTokenGroups* pGroups) const throw(...);
Parameter
pGroups
Zeiger auf das CTokenGroups Class-Objekt , das die Gruppeninformationen empfängt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetHandle
Rufen Sie diese Methode auf, um ein Handle für das Zugriffstoken abzurufen.
HANDLE GetHandle() const throw();
Rückgabewert
Gibt ein Handle an das Zugriffstoken des CAccessToken Objekts zurück.
CAccessToken::GetImpersonationLevel
Rufen Sie diese Methode auf, um die Identitätswechselebene aus dem Zugriffstoken abzurufen.
bool GetImpersonationLevel(
SECURITY_IMPERSONATION_LEVEL* pImpersonationLevel) const throw(...);
Parameter
pImpersonationLevel
Zeigen Sie auf einen SECURITY_IMPERSONATION_LEVEL Enumerationstyp, der informationen zur Identitätswechselebene empfängt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetLogonSessionId
Rufen Sie diese Methode auf, um die dem Objekt zugeordnete CAccessToken Anmeldesitzungs-ID abzurufen.
bool GetLogonSessionId(LUID* pluid) const throw(...);
Parameter
pluid
Zeigen Sie auf eine LUID , die die Anmeldesitzungs-ID empfängt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
In Debugbuilds tritt ein Assertionsfehler auf, wenn pluid ein ungültiger Wert ist.
CAccessToken::GetLogonSid
Rufen Sie diese Methode auf, um die dem Objekt zugeordnete CAccessToken Anmelde-SID abzurufen.
bool GetLogonSid(CSid* pSid) const throw(...);
Parameter
pSid
Zeiger auf ein CSid Class-Objekt .
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
In Debugbuilds tritt ein Assertionsfehler auf, wenn pSid ein ungültiger Wert ist.
CAccessToken::GetOwner
Rufen Sie diese Methode auf, um den besitzer abzurufen, der dem CAccessToken Objekt zugeordnet ist.
bool GetOwner(CSid* pSid) const throw(...);
Parameter
pSid
Zeiger auf ein CSid Class-Objekt .
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Der Besitzer wird standardmäßig für alle Objekte festgelegt, die erstellt wurden, während dieses Zugriffstoken wirksam ist.
CAccessToken::GetPrimaryGroup
Rufen Sie diese Methode auf, um die primäre Gruppe abzurufen, die dem CAccessToken Objekt zugeordnet ist.
bool GetPrimaryGroup(CSid* pSid) const throw(...);
Parameter
pSid
Zeiger auf ein CSid Class-Objekt .
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die Gruppe wird standardmäßig für alle Objekte festgelegt, die erstellt wurden, während dieses Zugriffstoken wirksam ist.
CAccessToken::GetPrivileges
Rufen Sie diese Methode auf, um die berechtigungen abzurufen, die dem CAccessToken Objekt zugeordnet sind.
bool GetPrivileges(CTokenPrivileges* pPrivileges) const throw(...);
Parameter
pPrivileges
Zeiger auf ein CTokenPrivileges Class-Objekt , das die Berechtigungen erhält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetProcessToken
Rufen Sie diese Methode auf, um CAccessToken mit dem Zugriffstoken aus einem Prozess zu initialisieren.
bool GetProcessToken(DWORD dwDesiredAccess, HANDLE hProcess = NULL) throw();
Parameter
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
hProcess
Handle an den Prozess, dessen Zugriffstoken geöffnet ist. Wenn der Standardwert von NULL verwendet wird, wird der aktuelle Prozess verwendet.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Ruft die OpenProcessToken Win32-Funktion auf.
CAccessToken::GetProfile
Rufen Sie diese Methode auf, um das Handle abzurufen, das auf das Benutzerprofil verweist, das dem CAccessToken Objekt zugeordnet ist.
HANDLE GetProfile() const throw();
Rückgabewert
Gibt ein Handle zurück, das auf das Benutzerprofil zeigt, oder NULL, wenn kein Profil vorhanden ist.
CAccessToken::GetSource
Rufen Sie diese Methode auf, um die Quelle des CAccessToken Objekts abzurufen.
bool GetSource(TOKEN_SOURCE* pSource) const throw(...);
Parameter
pSource
Zeiger auf eine TOKEN_SOURCE Struktur.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetStatistics
Rufen Sie diese Methode auf, um Informationen abzurufen, die dem CAccessToken Objekt zugeordnet sind.
bool GetStatistics(TOKEN_STATISTICS* pStatistics) const throw(...);
Parameter
pStatistics
Zeiger auf eine TOKEN_STATISTICS Struktur.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetTerminalServicesSessionId
Rufen Sie diese Methode auf, um die Sitzungs-ID der Terminaldienste abzurufen, die dem CAccessToken Objekt zugeordnet ist.
bool GetTerminalServicesSessionId(DWORD* pdwSessionId) const throw(...);
Parameter
pdwSessionId
Die Sitzungs-ID der Terminaldienste.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetThreadToken
Rufen Sie diese Methode auf, um das CAccessToken Token aus dem angegebenen Thread zu initialisieren.
bool GetThreadToken(
DWORD dwDesiredAccess,
HANDLE hThread = NULL,
bool bOpenAsSelf = true) throw();
Parameter
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
hThread
Behandeln Sie den Thread, dessen Zugriffstoken geöffnet wird.
bOpenAsSelf
Gibt an, ob die Zugriffsüberprüfung für den Sicherheitskontext des Threads, der die GetThreadToken Methode aufruft, oder für den Sicherheitskontext des Prozesses für den aufrufenden Thread vorgenommen werden soll.
Wenn dieser Parameter FALSE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts für den aufrufenden Thread ausgeführt. Wenn der Thread die Identität eines Clients angibt, kann dieser Sicherheitskontext der eines Clientprozesses sein. Wenn dieser Parameter TRUE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts des Prozesses für den aufrufenden Thread vorgenommen.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetTokenId
Rufen Sie diese Methode auf, um die dem Objekt zugeordnete CAccessToken Token-ID abzurufen.
bool GetTokenId(LUID* pluid) const throw(...);
Parameter
pluid
Zeiger auf eine LUID , die die Token-ID empfängt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::GetType
Rufen Sie diese Methode auf, um den Tokentyp des CAccessToken Objekts abzurufen.
bool GetType(TOKEN_TYPE* pType) const throw(...);
Parameter
pType
Adresse der TOKEN_TYPE Variablen, die bei Erfolg den Typ des Tokens empfängt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Der TOKEN_TYPE Enumerationstyp enthält Werte, die zwischen einem primären Token und einem Identitätswechseltoken unterscheiden.
CAccessToken::GetUser
Rufen Sie diese Methode auf, um den benutzer zu identifizieren, der dem CAccessToken Objekt zugeordnet ist.
bool GetUser(CSid* pSid) const throw(...);
Parameter
pSid
Zeiger auf ein CSid Class-Objekt .
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
CAccessToken::HKeyCurrentUser
Rufen Sie diese Methode auf, um das Handle abzurufen, das auf das Benutzerprofil verweist, das dem CAccessToken Objekt zugeordnet ist.
HKEY HKeyCurrentUser() const throw();
Rückgabewert
Gibt ein Handle zurück, das auf das Benutzerprofil zeigt, oder NULL, wenn kein Profil vorhanden ist.
CAccessToken::Identitätswechsel
Rufen Sie diese Methode auf, um einem Thread einen Identitätswechsel CAccessToken zuzuweisen.
bool Impersonate(HANDLE hThread = NULL) const throw(...);
Parameter
hThread
Behandeln Sie den Thread, um das Identitätswechseltoken zuzuweisen. Dieses Handle muss mit TOKEN_IMPERSONATE Zugriffsrechten geöffnet worden sein. Wenn hThread NULL ist, bewirkt die Methode, dass der Thread die Verwendung eines Identitätswechseltokens beendet.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
In Debugbuilds tritt ein Assertionsfehler auf, wenn CAccessToken kein gültiger Zeiger auf ein Token vorhanden ist.
Die CAutoRevertImpersonation-Klasse kann verwendet werden, um automatisch identitätswechselnde Zugriffstoken rückgängig machen.
CAccessToken::ImpersonateLoggedOnUser
Rufen Sie diese Methode auf, damit der aufrufende Thread den Sicherheitskontext eines angemeldeten Benutzers annehmen kann.
bool ImpersonateLoggedOnUser() const throw(...);
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Wichtig
Wenn ein Aufruf einer Identitätswechselfunktion aus irgendeinem Grund fehlschlägt, wird der Client nicht als Identitätswechsel bezeichnet, und die Clientanforderung wird im Sicherheitskontext des Prozesses ausgeführt, aus dem der Aufruf ausgeführt wurde. Wenn der Prozess als Konto mit hohem Privilegierten oder als Mitglied einer administrativen Gruppe ausgeführt wird, kann der Benutzer möglicherweise Aktionen ausführen, die er andernfalls nicht zulassen würde. Daher sollte der Rückgabewert für diese Funktion immer bestätigt werden.
CAccessToken::IsTokenRestricted
Rufen Sie diese Methode auf, um zu testen, ob das CAccessToken Objekt eine Liste eingeschränkter SIDs enthält.
bool IsTokenRestricted() const throw();
Rückgabewert
Gibt TRUE zurück, wenn das Objekt eine Liste der einschränkenden SIDs enthält, FALSE, wenn keine einschränkenden SIDs vorhanden sind oder wenn die Methode fehlschlägt.
CAccessToken::LoadUserProfile
Rufen Sie diese Methode auf, um das dem Objekt zugeordnete CAccessToken Benutzerprofil zu laden.
bool LoadUserProfile() throw(...);
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Bei Debugbuilds tritt ein Assertionsfehler auf, wenn das CAccessToken Token kein gültiges Token enthält oder ein Benutzerprofil bereits vorhanden ist.
CAccessToken::LogonUser
Rufen Sie diese Methode auf, um eine Anmeldesitzung für den Benutzer zu erstellen, der den angegebenen Anmeldeinformationen zugeordnet ist.
bool LogonUser(
LPCTSTR pszUserName,
LPCTSTR pszDomain,
LPCTSTR pszPassword,
DWORD dwLogonType = LOGON32_LOGON_INTERACTIVE,
DWORD dwLogonProvider = LOGON32_PROVIDER_DEFAULT) throw();
Parameter
pszUserName
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Benutzernamen angibt. Dies ist der Name des Benutzerkontos, bei dem sich anmelden soll.
pszDo Standard
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die den Namen des Do Standard- oder Servers angibt, dessen Kontodatenbank das pszUserName-Konto enthält.
pszPassword
Zeigen Sie auf eine mit Null beendete Zeichenfolge, die das Klartextkennwort für das von pszUserName angegebene Benutzerkonto angibt.
dwLogonType
Gibt den Typ des auszuführenden Anmeldevorgangs an. Weitere Informationen finden Sie unter "LogonUser ".
dwLogonProvider
Gibt den Anmeldeanbieter an. Weitere Informationen finden Sie unter "LogonUser ".
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Das Zugriffstoken, das sich aus der Anmeldung ergibt, wird dem CAccessTokenzugeordnet. Damit diese Methode erfolgreich ist, muss das CAccessToken Objekt SE_TCB_NAME Berechtigungen enthalten und den Halter als Teil der vertrauenswürdigen Computerbasis identifizieren. Weitere Informationen zu den erforderlichen Berechtigungen finden Sie unter "LogonUser ".
CAccessToken::OpenCOMClientToken
Rufen Sie diese Methode von einem COM-Server auf, der einen Aufruf eines Clients verarbeitet, um das CAccessToken Zugriffstoken vom COM-Client zu initialisieren.
bool OpenCOMClientToken(
DWORD dwDesiredAccess,
bool bImpersonate = false,
bool bOpenAsSelf = true) throw(...);
Parameter
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
bImpersonate
Wenn TRUE, wird der aktuelle Thread die Identität des aufrufenden COM-Clients annehmen, wenn dieser Aufruf erfolgreich abgeschlossen ist. Wenn FALSE, wird das Zugriffstoken geöffnet, der Thread verfügt jedoch nicht über ein Identitätswechseltoken, wenn dieser Aufruf abgeschlossen ist.
bOpenAsSelf
Gibt an, ob die Zugriffsüberprüfung für den Sicherheitskontext des Threads ausgeführt werden soll, der die GetThreadToken-Methode aufruft, oder anhand des Sicherheitskontexts des Prozesses für den aufrufenden Thread.
Wenn dieser Parameter FALSE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts für den aufrufenden Thread ausgeführt. Wenn der Thread die Identität eines Clients angibt, kann dieser Sicherheitskontext der eines Clientprozesses sein. Wenn dieser Parameter TRUE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts des Prozesses für den aufrufenden Thread vorgenommen.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die CAutoRevertImpersonation-Klasse kann verwendet werden, um automatisch identitätswechselnde Zugriffstoken zu rückgängig machen, die durch Festlegen des bImpersonate-Flags auf TRUE erstellt wurden.
CAccessToken::OpenNamedPipeClientToken
Rufen Sie diese Methode von einem Server auf, der Anforderungen über eine benannte Pipe übernimmt, um das CAccessToken Zugriffstoken vom Client zu initialisieren.
bool OpenNamedPipeClientToken(
HANDLE hPipe,
DWORD dwDesiredAccess,
bool bImpersonate = false,
bool bOpenAsSelf = true) throw(...);
Parameter
hPipe
Handle zu einer benannten Pipe.
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
bImpersonate
Wenn TRUE, wird der aktuelle Thread den Anrufpipelineclient annehmen, wenn dieser Aufruf erfolgreich abgeschlossen wurde. Wenn FALSE, wird das Zugriffstoken geöffnet, der Thread verfügt jedoch nicht über ein Identitätswechseltoken, wenn dieser Aufruf abgeschlossen ist.
bOpenAsSelf
Gibt an, ob die Zugriffsüberprüfung für den Sicherheitskontext des Threads ausgeführt werden soll, der die GetThreadToken-Methode aufruft, oder anhand des Sicherheitskontexts des Prozesses für den aufrufenden Thread.
Wenn dieser Parameter FALSE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts für den aufrufenden Thread ausgeführt. Wenn der Thread die Identität eines Clients angibt, kann dieser Sicherheitskontext der eines Clientprozesses sein. Wenn dieser Parameter TRUE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts des Prozesses für den aufrufenden Thread vorgenommen.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die CAutoRevertImpersonation-Klasse kann verwendet werden, um automatisch identitätswechselnde Zugriffstoken zu rückgängig machen, die durch Festlegen des bImpersonate-Flags auf TRUE erstellt wurden.
CAccessToken::OpenRPCClientToken
Rufen Sie diese Methode von einem Server auf, der einen Aufruf eines RPC-Clients verarbeitet, um das CAccessToken Zugriffstoken vom Client zu initialisieren.
bool OpenRPCClientToken(
RPC_BINDING_HANDLE BindingHandle,
DWORD dwDesiredAccess,
bool bImpersonate = false,
bool bOpenAsSelf = true) throw(...);
Parameter
BindingHandle
Bindungshandle auf dem Server, das eine Bindung an einen Client darstellt.
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
bImpersonate
Wenn TRUE, wird der aktuelle Thread die Identität des aufrufenden RPC-Clients annehmen, wenn dieser Aufruf erfolgreich abgeschlossen ist. Wenn FALSE, wird das Zugriffstoken geöffnet, der Thread verfügt jedoch nicht über ein Identitätswechseltoken, wenn dieser Aufruf abgeschlossen ist.
bOpenAsSelf
Gibt an, ob die Zugriffsüberprüfung für den Sicherheitskontext des Threads ausgeführt werden soll, der die GetThreadToken-Methode aufruft, oder anhand des Sicherheitskontexts des Prozesses für den aufrufenden Thread.
Wenn dieser Parameter FALSE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts für den aufrufenden Thread ausgeführt. Wenn der Thread die Identität eines Clients angibt, kann dieser Sicherheitskontext der eines Clientprozesses sein. Wenn dieser Parameter TRUE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts des Prozesses für den aufrufenden Thread vorgenommen.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die CAutoRevertImpersonation-Klasse kann verwendet werden, um automatisch identitätswechselnde Zugriffstoken zu rückgängig machen, die durch Festlegen des bImpersonate-Flags auf TRUE erstellt wurden.
CAccessToken::OpenThreadToken
Rufen Sie diese Methode auf, um die Identitätswechselebene festzulegen und dann das CAccessToken Token aus dem angegebenen Thread zu initialisieren.
bool OpenThreadToken(
DWORD dwDesiredAccess,
bool bImpersonate = false,
bool bOpenAsSelf = true,
SECURITY_IMPERSONATION_LEVEL sil = SecurityImpersonation) throw(...);
Parameter
dwDesiredAccess
Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für den Zugriff auf das Zugriffstoken identifiziert. Diese angeforderten Zugriffstypen werden mit der DACL des Tokens verglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.
bImpersonate
Wenn TRUE, wird der Thread nach Abschluss dieser Methode auf der angeforderten Identitätswechselebene verbleiben. Wenn FALSE, wird der Thread auf die ursprüngliche Identitätswechselebene rückgängig machen.
bOpenAsSelf
Gibt an, ob die Zugriffsüberprüfung für den Sicherheitskontext des Threads ausgeführt werden soll, der die GetThreadToken-Methode aufruft, oder anhand des Sicherheitskontexts des Prozesses für den aufrufenden Thread.
Wenn dieser Parameter FALSE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts für den aufrufenden Thread ausgeführt. Wenn der Thread die Identität eines Clients angibt, kann dieser Sicherheitskontext der eines Clientprozesses sein. Wenn dieser Parameter TRUE ist, wird die Zugriffsüberprüfung mithilfe des Sicherheitskontexts des Prozesses für den aufrufenden Thread vorgenommen.
sil
Gibt einen SECURITY_IMPERSONATION_LEVEL aufgezählten Typ an, der die Identitätswechselebene des Tokens bereitstellt.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
OpenThreadTokenähnelt CAccessToken::GetThreadToken, legt jedoch die Identitätswechselebene fest, bevor das CAccessToken Zugriffstoken des Threads initialisiert wird.
Die CAutoRevertImpersonation-Klasse kann verwendet werden, um automatisch identitätswechselnde Zugriffstoken zu rückgängig machen, die durch Festlegen des bImpersonate-Flags auf TRUE erstellt wurden.
CAccessToken::P rivilegeCheck
Rufen Sie diese Methode auf, um zu bestimmen, ob eine bestimmte Gruppe von Berechtigungen im CAccessToken Objekt aktiviert ist.
bool PrivilegeCheck(
PPRIVILEGE_SET RequiredPrivileges,
bool* pbResult) const throw();
Parameter
RequiredPrivileges
Zeiger auf eine PRIVILEGE_SET Struktur.
pbResult
Zeigen Sie auf einen Wert, den die Methode festlegt, um anzugeben, ob eine oder alle angegebenen Berechtigungen im CAccessToken Objekt aktiviert sind.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Bei PrivilegeCheck Rückgabe wird das Attributes Element jeder LUID_AND_ATTRIBUTES Struktur auf SE_PRIVILEGE_USED_FOR_ACCESS festgelegt, wenn die entsprechenden Berechtigungen aktiviert sind. Diese Methode ruft die PrivilegeCheck Win32-Funktion auf.
CAccessToken::Revert
Rufen Sie diese Methode auf, um zu verhindern, dass ein Thread ein Identitätswechseltoken verwendet.
bool Revert(HANDLE hThread = NULL) const throw();
Parameter
hThread
Behandeln Sie den Thread, um den Identitätswechsel zu rückgängig machen. Wenn hThread NULL ist, wird der aktuelle Thread angenommen.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die Umversion von Identitätswechseltoken kann automatisch mit der CAutoRevertImpersonation-Klasse ausgeführt werden.
CAccessToken::SetDefaultDacl
Rufen Sie diese Methode auf, um die standardmäßige DACL des CAccessToken Objekts festzulegen.
bool SetDefaultDacl(const CDacl& rDacl) throw(...);
Parameter
rDacl
Die neuen CDacl-Standardklasseninformationen.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die Standardmäßige DACL ist die DACL, die standardmäßig verwendet wird, wenn neue Objekte mit diesem Zugriffstoken erstellt werden.
CAccessToken::SetOwner
Rufen Sie diese Methode auf, um den Besitzer des CAccessToken Objekts festzulegen.
bool SetOwner(const CSid& rSid) throw(...);
Parameter
rSid
Das CSid Class-Objekt , das die Besitzerinformationen enthält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Der Besitzer ist der Standardbesitzer, der für neue Objekte verwendet wird, die erstellt wurden, während dieses Zugriffstoken wirksam ist.
CAccessToken::SetPrimaryGroup
Rufen Sie diese Methode auf, um die primäre Gruppe des CAccessToken Objekts festzulegen.
bool SetPrimaryGroup(const CSid& rSid) throw(...);
Parameter
rSid
Das CSid Class-Objekt , das die primären Gruppeninformationen enthält.
Rückgabewert
Gibt WAHR für Erfolg, FALSE bei Fehler zurück.
Hinweise
Die primäre Gruppe ist die Standardgruppe für neue Objekte, die erstellt wurden, während dieses Zugriffstoken wirksam ist.
Siehe auch
Feedback
Bald verfügbar: Im Laufe des Jahres 2024 werden wir GitHub-Issues stufenweise als Feedbackmechanismus für Inhalte abbauen und durch ein neues Feedbacksystem ersetzen. Weitere Informationen finden Sie unter https://aka.ms/ContentUserFeedback.
Feedback senden und anzeigen für