Função ContinueDebugEvent (debugapi.h)

  • Artigo

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
DBG_CONTINUE
0x00010002L
 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.
DBG_EXCEPTION_NOT_HANDLED
0x80010001L
 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.
DBG_REPLY_LATER
0x40010001L
 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

Confira também

CreateProcess

Eventos de depuração

Funções de depuração