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)

Confira também

CreateProcess

Createprocessasuser

CreateProcessWithLogonW

CreateProcessWithTokenW