GetCurrentProcess-Funktion (processthreadsapi.h)

Artikel
02/07/2024

Ruft ein Pseudohandle für den aktuellen Prozess ab.

Syntax

HANDLE GetCurrentProcess();

Rückgabewert

Der Rückgabewert ist ein Pseudohandle für den aktuellen Prozess.

Hinweise

Ein Pseudohandle ist eine spezielle Konstante(derzeit HANDLE)-1, die als aktuelles Prozesshandle interpretiert wird. Aus Gründen der Kompatibilität mit zukünftigen Betriebssystemen empfiehlt es sich, GetCurrentProcess aufzurufen, anstatt diesen konstanten Wert hart zu codieren. Der aufrufende Prozess kann ein Pseudohandle verwenden, um seinen eigenen Prozess anzugeben, wenn ein Prozesshandle erforderlich ist. Pseudohandles werden nicht von untergeordneten Prozessen geerbt.

Dieses Handle verfügt über das PROCESS_ALL_ACCESS Zugriffsrecht auf das Prozessobjekt. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Dieses Handle verfügt über den maximalen Zugriff, der vom Sicherheitsdeskriptor des Prozesses auf das primäre Token des Prozesses zulässig ist.

Ein Prozess kann ein "echtes" Handle für sich selbst erstellen, das im Kontext anderer Prozesse gültig ist oder von anderen Prozessen geerbt werden kann, indem er das Pseudohandle als Quellhandle in einem Aufruf der DuplicateHandle-Funktion angibt. Ein Prozess kann auch die OpenProcess-Funktion verwenden, um ein echtes Handle für sich selbst zu öffnen.

Das Pseudohandle muss nicht geschlossen werden, wenn es nicht mehr benötigt wird. Das Aufrufen der CloseHandle-Funktion mit einem Pseudohandle hat keine Auswirkungen. Wenn das Pseudohandle von DuplicateHandle dupliziert wird, muss das doppelte Handle geschlossen werden.

Beispiele

Ein Beispiel finden Sie unter Erstellen eines untergeordneten Prozesses mit umgeleiteter Eingabe und Ausgabe.

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 (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll