структура PROCESS_INFORMATION (processthreadsapi.h)
Содержит сведения о вновь созданном процессе и его основном потоке. Он используется с функцией CreateProcess, CreateProcessAsUser, CreateProcessWithLogonW или CreateProcessWithTokenW .
Синтаксис
typedef struct _PROCESS_INFORMATION {
HANDLE hProcess;
HANDLE hThread;
DWORD dwProcessId;
DWORD dwThreadId;
} PROCESS_INFORMATION, *PPROCESS_INFORMATION, *LPPROCESS_INFORMATION;
Члены
hProcess
Дескриптор созданного процесса. Дескриптор используется для указания процесса во всех функциях, выполняющих операции с объектом процесса.
hThread
Дескриптор основного потока созданного процесса. Дескриптор используется для указания потока во всех функциях, выполняющих операции с объектом потока.
dwProcessId
Значение, которое можно использовать для идентификации процесса. Значение допустимо с момента создания процесса до закрытия всех дескрипторов процесса и освобождения объекта процесса; На этом этапе идентификатор может использоваться повторно.
dwThreadId
Значение, которое можно использовать для идентификации потока. Значение допустимо с момента создания потока до закрытия всех дескрипторов потока и освобождения объекта потока; На этом этапе идентификатор может использоваться повторно.
Комментарии
Если функция выполнена успешно, обязательно вызовите функцию CloseHandle , чтобы закрыть дескрипторы hProcess и hThread по завершении работы с ними. В противном случае при выходе дочернего процесса система не сможет очистить структуры процессов для дочернего процесса, так как родительский процесс по-прежнему имеет открытые дескрипторы для дочернего процесса. Однако система закроет эти дескрипторы при завершении родительского процесса, поэтому структуры, связанные с объектом дочернего процесса, будут очищены на этом этапе.
Примеры
Пример см. в разделе Создание процессов.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows XP [только классические приложения] |
| Минимальная версия сервера | Windows Server 2003 [только классические приложения] |
| Верхняя часть | processthreadsapi.h (включая Windows.h в Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |