PROCESS_INFORMATION-Struktur (processthreadsapi.h)

  • Artikel

Enthält Informationen zu einem neu erstellten Prozess und seinem primären Thread. Sie wird mit der Funktion CreateProcess, CreateProcessAsUser, CreateProcessWithLogonW oder CreateProcessWithTokenW verwendet.

Syntax

typedef struct _PROCESS_INFORMATION {
  HANDLE hProcess;
  HANDLE hThread;
  DWORD  dwProcessId;
  DWORD  dwThreadId;
} PROCESS_INFORMATION, *PPROCESS_INFORMATION, *LPPROCESS_INFORMATION;

Member

hProcess

Ein Handle für den neu erstellten Prozess. Das Handle wird verwendet, um den Prozess in allen Funktionen anzugeben, die Vorgänge für das Prozessobjekt ausführen.

hThread

Ein Handle für den primären Thread des neu erstellten Prozesses. Das Handle wird verwendet, um den Thread in allen Funktionen anzugeben, die Vorgänge für das Threadobjekt ausführen.

dwProcessId

Ein Wert, der verwendet werden kann, um einen Prozess zu identifizieren. Der Wert ist gültig ab dem Zeitpunkt, zu dem der Prozess erstellt wird, bis alle Handles für den Prozess geschlossen und das Prozessobjekt freigegeben wird. an diesem Punkt kann der Bezeichner wiederverwendet werden.

dwThreadId

Ein -Wert, der verwendet werden kann, um einen Thread zu identifizieren. Der Wert ist gültig ab dem Zeitpunkt, zu dem der Thread erstellt wird, bis alle Handles für den Thread geschlossen und das Threadobjekt freigegeben wird. an diesem Punkt kann der Bezeichner wiederverwendet werden.

Hinweise

Wenn die Funktion erfolgreich ist, müssen Sie die CloseHandle-Funktion aufrufen, um die hProcess - und hThread-Handles zu schließen, wenn Sie damit fertig sind. Andernfalls kann das System beim Beenden des untergeordneten Prozesses die Prozessstrukturen für den untergeordneten Prozess nicht sauber, da der übergeordnete Prozess noch offene Handles für den untergeordneten Prozess aufweist. Das System schließt diese Handles jedoch, wenn der übergeordnete Prozess beendet wird, sodass die Strukturen im Zusammenhang mit dem untergeordneten Prozessobjekt an diesem Punkt bereinigt werden.

Beispiele

Ein Beispiel finden Sie unter Erstellen von Prozessen.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server) Windows Server 2003 [nur Desktop-Apps]
Kopfzeile processthreadsapi.h (enthalten Windows.h unter Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2)

Weitere Informationen

CreateProcess

CreateProcessAsUser

CreateProcessWithLogonW

CreateProcessWithTokenW