PROCESS_INFORMATION-Struktur (processthreadsapi.h)
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) |