Função ContinueDebugEvent (debugapi.h)
Permite que um depurador continue um thread que relatou anteriormente um evento de depuração.
Sintaxe
BOOL ContinueDebugEvent(
[in] DWORD dwProcessId,
[in] DWORD dwThreadId,
[in] DWORD dwContinueStatus
);
Parâmetros
[in] dwProcessId
O identificador de processo do processo a ser continuado.
[in] dwThreadId
O identificador de thread do thread a ser continuado. A combinação de identificador de processo e identificador de thread deve identificar um thread que relatou anteriormente um evento de depuração.
[in] dwContinueStatus
As opções para continuar o thread que relatou o evento de depuração.
| Valor | Significado |
|---|---|
|
Se o thread especificado pelo parâmetro dwThreadId relatou anteriormente um evento de depuração EXCEPTION_DEBUG_EVENT, a função interrompe todo o processamento de exceção e continua o thread e a exceção é marcada como tratada. Para qualquer outro evento de depuração, esse sinalizador simplesmente continua o thread. |
|
Se o thread especificado por dwThreadId relatou anteriormente um evento de depuração EXCEPTION_DEBUG_EVENT, a função continuará o processamento de exceção. Se esse for um evento de exceção de primeira chance, a lógica de pesquisa e expedição do manipulador de exceção estruturado será usada; caso contrário, o processo será encerrado. Para qualquer outro evento de depuração, esse sinalizador simplesmente continua o thread. |
|
Com suporte no Windows 10, versão 1507 ou superior, esse sinalizador faz com que dwThreadId reproduza o evento de interrupção existente após o destino continuar. Ao chamar a API SuspendThread em relação a dwThreadId, um depurador pode retomar outros threads no processo e, posteriormente, retornar à quebra. |
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
Somente o thread que criou dwProcessId com a função CreateProcess pode chamar ContinueDebugEvent.
Depois que a função ContinueDebugEvent for bem-sucedida, o thread especificado continuará. Dependendo do evento de depuração relatado anteriormente pelo thread, diferentes ações ocorrem. Se o thread contínuo relatou anteriormente um evento de depuração EXIT_THREAD_DEBUG_EVENT, ContinueDebugEvent fechará o identificador que o depurador tem para o thread. Se o thread contínuo relatou anteriormente um evento de depuração EXIT_PROCESS_DEBUG_EVENT, ContinueDebugEvent fechará os identificadores que o depurador tem para o processo e para o thread.
Exemplos
Para obter um exemplo, consulte Escrevendo o loop principal do depurador.
Requisitos
| 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] |
| Plataforma de Destino | Windows |
| Cabeçalho | debugapi.h (inclua Windows.h) |
| Biblioteca | Kernel32.lib |
| DLL | Kernel32.dll |