структура 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)

См. также раздел

CreateProcess

CreateProcessAsUser

CreateProcessWithLogonW

CreateProcessWithTokenW