GetProcessId-Funktion (processthreadsapi.h)

Artikel
03/04/2024

Ruft den Prozessbezeichner des angegebenen Prozesses ab.

Syntax

DWORD GetProcessId(
  [in] HANDLE Process
);

Parameter

[in] Process

Ein Handle für den Prozess. Das Handle muss über das PROCESS_QUERY_INFORMATION- oder PROCESS_QUERY_LIMITED_INFORMATION-Zugriffsrecht verfügen. Weitere Informationen finden Sie unter Prozesssicherheit und Zugriffsrechte.

Windows Server 2003 und Windows XP: Das Handle muss über das PROCESS_QUERY_INFORMATION-Zugriffsrecht verfügen.

Rückgabewert

Wenn die Funktion erfolgreich ist, ist der Rückgabewert der Prozessbezeichner.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

Bis ein Prozess beendet wird, identifiziert der Prozessbezeichner ihn eindeutig auf dem System. Weitere Informationen zu Zugriffsrechten finden Sie unter Prozesssicherheit und Zugriffsrechte.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista, Windows XP mit SP1 [Desktop-Apps \| UWP-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [Desktop-Apps \| UWP-Apps]
Zielplattform	Windows
Kopfzeile	processthreadsapi.h (einschließlich Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll

Siehe auch