OpenProcessToken-Funktion (processthreadsapi.h)

Artikel
08/25/2023

Die OpenProcessToken-Funktion öffnet das Zugriffstoken , das einem Prozess zugeordnet ist.

Syntax

BOOL OpenProcessToken(
  [in]  HANDLE  ProcessHandle,
  [in]  DWORD   DesiredAccess,
  [out] PHANDLE TokenHandle
);

Parameter

[in] ProcessHandle

Ein Handle für den Prozess, dessen Zugriffstoken geöffnet wird. Der Prozess muss über die Zugriffsberechtigung PROCESS_QUERY_LIMITED_INFORMATION verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte .

[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 verglichen, 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.

[out] TokenHandle

Ein Zeiger auf ein Handle, das das neu geöffnete Zugriffstoken identifiziert, wenn die Funktion zurückgegeben wird.

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.

Hinweise

Um ein Handle für einen Prozess mit erhöhten Rechten aus einem Prozess ohne rechte Rechte abzurufen, müssen beide Prozesse über dasselbe Konto gestartet werden.

Wenn der überprüfte Prozess von einem anderen Konto gestartet wurde, muss für den Überprüfungsprozess die Berechtigung SE_DEBUG_NAME aktiviert sein. Weitere Informationen finden Sie unter Berechtigungskonstanten (Autorisierung).

Um das Zugriffstokenhandle zu schließen, das über den TokenHandle-Parameter zurückgegeben wird, rufen Sie CloseHandle auf.

Anforderungen

Anforderung	Wert
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