Função GetExitCodeProcess (processthreadsapi.h)
Recupera o status de encerramento do processo especificado.
Sintaxe
BOOL GetExitCodeProcess(
[in] HANDLE hProcess,
[out] LPDWORD lpExitCode
);
Parâmetros
[in] hProcess
Um identificador para o processo.
O identificador deve ter o acesso PROCESS_QUERY_INFORMATION ou PROCESS_QUERY_LIMITED_INFORMATION direito. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.
Windows Server 2003 e Windows XP: O identificador deve ter o acesso de PROCESS_QUERY_INFORMATION correto.
[out] lpExitCode
Um ponteiro para uma variável para receber o status de encerramento do processo. Para obter mais informações, consulte Comentários.
Valor retornado
Se a função for bem-sucedida, o valor retornado será diferente de zero.
Se a função falhar, o valor retornado será zero. Para obter informações de erro estendidas, chame GetLastError.
Comentários
Essa função retorna imediatamente. Se o processo não tiver terminado e a função for bem-sucedida, o status retornado será STILL_ACTIVE (uma macro para STATUS_PENDING (minwinbase.h)). Se o processo tiver terminado e a função for bem-sucedida, o status retornado será um dos seguintes valores:
- O valor de saída especificado na função ExitProcess ou TerminateProcess .
- O valor retornado da função main ou WinMain do processo.
- O valor de exceção de uma exceção sem tratamento que fez com que o processo terminasse.
Importante
A função GetExitCodeProcess retorna um código de erro válido definido pelo aplicativo somente após o término do thread. Portanto, um aplicativo não deve usar STILL_ACTIVE (259) como um código de erro (STILL_ACTIVE é uma macro para STATUS_PENDING (minwinbase.h)). Se um thread retornar STILL_ACTIVE (259) como um código de erro, os aplicativos que testam esse valor poderão interpretá-lo para significar que o thread ainda está em execução e continuar a testar a conclusão do thread após o término do thread, o que pode colocar o aplicativo em um loop infinito.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP [aplicativos da área de trabalho | aplicativos UWP] |
| Servidor mínimo com suporte | Windows Server 2003 [aplicativos da área de trabalho | Aplicativos UWP] |
| Plataforma de Destino | Windows |
| Cabeçalho | processthreadsapi.h (inclua Windows.h no Windows Server 2003, Windows Vista, Windows 7, Windows Server 2008 Windows Server 2008 R2) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |