Função GetExitCodeThread (processthreadsapi.h)
Recupera o status de encerramento do thread especificado.
Sintaxe
BOOL GetExitCodeThread(
[in] HANDLE hThread,
[out] LPDWORD lpExitCode
);
Parâmetros
[in] hThread
Um identificador para o thread.
O identificador deve ter o acesso de THREAD_QUERY_INFORMATION ou THREAD_QUERY_LIMITED_INFORMATION direito. Para obter mais informações, consulte Segurança de thread e direitos de acesso.
Windows Server 2003 e Windows XP: O identificador deve ter o acesso de THREAD_QUERY_INFORMATION correto.
[out] lpExitCode
Um ponteiro para uma variável para receber o status de encerramento do thread. 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 thread especificado não tiver terminado e a função for bem-sucedida, o status retornado será STILL_ACTIVE. Se o thread 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 ExitThread ou TerminateThread .
- O valor retornado da função thread.
- O valor de saída do processo do thread.
Windows 8.1 e Windows Server 2012 R2: essa função tem suporte para aplicativos da Windows Store em Windows 8.1, Windows Server 2012 R2 e posteriores.
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; WindowsPhoneCore.lib no Windows Phone 8.1 |
DLL | Kernel32.dll; KernelBase.dll no Windows Phone 8.1 |