PROCESSENTRY32W Struktur (tlhelp32.h)

Beschreibt einen Eintrag aus einer Liste der Prozesse, die sich im Systemadressbereich befinden, als eine Momentaufnahme erstellt wurde.

Syntax

typedef struct tagPROCESSENTRY32W {
  DWORD     dwSize;
  DWORD     cntUsage;
  DWORD     th32ProcessID;
  ULONG_PTR th32DefaultHeapID;
  DWORD     th32ModuleID;
  DWORD     cntThreads;
  DWORD     th32ParentProcessID;
  LONG      pcPriClassBase;
  DWORD     dwFlags;
  WCHAR     szExeFile[MAX_PATH];
} PROCESSENTRY32W;

Angehörige

dwSize

Die Größe der Struktur in Byte. Legen Sie vor dem Aufrufen der Process32First--Funktion dieses Elements auf sizeof(PROCESSENTRY32)fest. Wenn Sie dwSizenicht initialisieren, schlägt Process32First- fehl.

cntUsage

Dieses Element wird nicht mehr verwendet und ist immer auf Null festgelegt.

th32ProcessID

Der Prozessbezeichner.

th32DefaultHeapID

Dieses Element wird nicht mehr verwendet und ist immer auf Null festgelegt.

th32ModuleID

Dieses Element wird nicht mehr verwendet und ist immer auf Null festgelegt.

cntThreads

Die Anzahl der vom Prozess gestarteten Ausführungsthreads.

th32ParentProcessID

Der Bezeichner des Prozesses, der diesen Prozess erstellt hat (dessen übergeordneter Prozess).

pcPriClassBase

Die Basispriorität aller Threads, die von diesem Prozess erstellt wurden.

dwFlags

Dieses Element wird nicht mehr verwendet und ist immer auf Null festgelegt.

szExeFile[MAX_PATH]

Der Name der ausführbaren Datei für den Prozess. Rufen Sie zum Abrufen des vollständigen Pfads zur ausführbaren Datei die Module32First--Funktion auf, und überprüfen Sie das szExePath- element der zurückgegebenen MODULEENTRY32 Struktur. Wenn der Aufrufvorgang jedoch ein 32-Bit-Prozess ist, müssen Sie den QueryFullProcessImageName-Funktion aufrufen, um den vollständigen Pfad der ausführbaren Datei für einen 64-Bit-Prozess abzurufen.

Bemerkungen

Anmerkung

Der tlhelp32.h-Header definiert PROCESSENTRY32 als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows XP [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Header-	tlhelp32.h

Siehe auch

Process32First-

Process32Next-