estrutura PROCESS_INFORMATION (processthreadsapi.h)
Contém informações sobre um processo recém-criado e seu thread primário. Ele é usado com a função CreateProcess, CreateProcessAsUser, CreateProcessWithLogonW ou CreateProcessWithTokenW .
Sintaxe
typedef struct _PROCESS_INFORMATION {
HANDLE hProcess;
HANDLE hThread;
DWORD dwProcessId;
DWORD dwThreadId;
} PROCESS_INFORMATION, *PPROCESS_INFORMATION, *LPPROCESS_INFORMATION;
Membros
hProcess
Um identificador para o processo recém-criado. O identificador é usado para especificar o processo em todas as funções que executam operações no objeto de processo.
hThread
Um identificador para o thread primário do processo recém-criado. O identificador é usado para especificar o thread em todas as funções que executam operações no objeto de thread.
dwProcessId
Um valor que pode ser usado para identificar um processo. O valor é válido a partir do momento em que o processo é criado até que todos os identificadores para o processo sejam fechados e o objeto de processo seja liberado; neste ponto, o identificador pode ser reutilizado.
dwThreadId
Um valor que pode ser usado para identificar um thread. O valor é válido a partir do momento em que o thread é criado até que todos os identificadores para o thread sejam fechados e o objeto thread seja liberado; neste ponto, o identificador pode ser reutilizado.
Comentários
Se a função for bem-sucedida, certifique-se de chamar a função CloseHandle para fechar os identificadores hProcess e hThread quando tiver terminado com eles. Caso contrário, quando o processo filho é encerrado, o sistema não pode limpo as estruturas de processo para o processo filho porque o processo pai ainda tem alças abertas para o processo filho. No entanto, o sistema fechará esses identificadores quando o processo pai for encerrado, para que as estruturas relacionadas ao objeto de processo filho sejam limpas neste ponto.
Exemplos
Para obter um exemplo, consulte Criando processos.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [somente aplicativos da área de trabalho] |
| Servidor mínimo com suporte | Windows Server 2003 [somente aplicativos da área de trabalho] |
| Cabeçalho | processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |