Freigeben über


OpenProcessToken-Funktion (processthreadsapi.h)

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

Weitere Informationen

Zugriffssteuerung

Grundlegende Access Control-Funktionen

AccessCheck

AdjustTokenGroups

AdjustTokenPrivileges

CloseHandle

GetCurrentProcessToken

GetCurrentThreadEffectiveToken

GetCurrentThreadToken

GetTokenInformation

OpenThreadToken

SetTokenInformation