OpenThreadToken-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Die OpenThreadToken-Funktion öffnet das Zugriffstoken , das einem Thread zugeordnet ist.

Syntax

BOOL OpenThreadToken(
  [in]  HANDLE  ThreadHandle,
  [in]  DWORD   DesiredAccess,
  [in]  BOOL    OpenAsSelf,
  [out] PHANDLE TokenHandle
);

Parameter

[in] ThreadHandle

Ein Handle für den Thread, dessen Zugriffstoken geöffnet wird.

[in] DesiredAccess

Gibt eine Zugriffsmaske an, die die angeforderten Zugriffstypen für das Zugriffstoken angibt. Diese angeforderten Zugriffstypen werden mit der daCL (Discretionary Access Control List ) des Tokens abgeglichen, um zu bestimmen, welche Zugriffe gewährt oder verweigert werden.

Eine Liste der Zugriffsrechte für Zugriffstoken finden Sie unter Zugriffsrechte für Access-Token Objects.

[in] OpenAsSelf

TRUE, wenn die Zugriffsüberprüfung für den Sicherheitskontext auf Prozessebene durchgeführt werden soll.

FALSE , wenn die Zugriffsüberprüfung für den aktuellen Sicherheitskontext des Threads durchgeführt werden soll, der die OpenThreadToken-Funktion aufruft .

Der OpenAsSelf-Parameter ermöglicht es dem Aufrufer dieser Funktion, das Zugriffstoken eines angegebenen Threads zu öffnen, wenn der Aufrufer die Identität eines Tokens auf SecurityIdentification-Ebene angibt. Ohne diesen Parameter kann der aufrufende Thread das Zugriffstoken für den angegebenen Thread nicht öffnen, da es unmöglich ist, Objekte auf Führungsebene mithilfe der SecurityIdentification-Identitätswechselebene zu öffnen.

[out] TokenHandle

Ein Zeiger auf eine Variable, die das Handle für das neu geöffnete Zugriffstoken empfängt.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf. Wenn das Token die anonyme Identitätswechselebene aufweist, wird das Token nicht geöffnet, und OpenThreadToken legt ERROR_CANT_OPEN_ANONYMOUS als Fehler fest.

Hinweise

Token mit der anonymen Identitätswechselebene können nicht geöffnet werden.

Schließen Sie das Zugriffstokenhandle, das über den TokenHandle-Parameter zurückgegeben wird, indem Sie CloseHandle aufrufen.

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (include Windows.h)
Bibliothek	Advapi32.lib
DLL	Advapi32.dll