Função TerminateProcess (processthreadsapi.h)

Artigo
02/07/2024

Encerra o processo especificado e todos os seus threads.

Sintaxe

BOOL TerminateProcess(
  [in] HANDLE hProcess,
  [in] UINT   uExitCode
);

Parâmetros

[in] hProcess

Um identificador para o processo a ser encerrado.

O identificador deve ter o acesso de PROCESS_TERMINATE correto. Para obter mais informações, consulte Direitos de Acesso e Segurança do Processo.

[in] uExitCode

O código de saída a ser usado pelo processo e os threads encerrados como resultado dessa chamada. Use a função GetExitCodeProcess para recuperar o valor de saída de um processo. Use a função GetExitCodeThread para recuperar o valor de saída de um thread.

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

A função TerminateProcess é usada para fazer com que um processo seja encerrado incondicionalmente. O estado dos dados globais mantidos por DLLs (bibliotecas de vínculo dinâmico) pode ser comprometido se TerminateProcess for usado em vez de ExitProcess.

Essa função interrompe a execução de todos os threads dentro do processo e solicita o cancelamento de todas as E/S pendentes. O processo encerrado não poderá sair até que toda e/S pendente seja concluída ou cancelada. Quando um processo é encerrado, seu objeto kernel não é destruído até que todos os processos que têm identificadores abertos para o processo liberem esses identificadores.

Quando um processo é encerrado, TerminateProcess interrompe a execução do thread de chamada e não retorna. Caso contrário, TerminateProcess será assíncrono; ele inicia o encerramento e retorna imediatamente. Se você precisar ter certeza de que o processo foi encerrado, chame a função WaitForSingleObject com um identificador para o processo.

Um processo não pode impedir que ele seja encerrado.

Depois que um processo for encerrado, a chamada para TerminateProcess com identificadores abertos para o processo falhará com ERROR_ACCESS_DENIED (5) código de erro.

Requisitos


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