Partilhar via


IDebugEngine2

Essa interface representa um mecanismo de depuração (DE). Ele é usado para gerenciar vários aspectos de uma sessão de depuração, desde a criação de pontos de interrupção para a definição e limpando exceções.

IDebugEngine2 : IUnknown

Observações para Implementadores

Essa interface é implementada por um DE personalizado para gerenciar a depuração de programas. Esta interface deve ser implementada por DE.

Observações para chamadores

Essa interface é chamada pelo Gerenciador de sessão de depuração (SDM) para gerenciar a sessão de depuração, incluindo gerenciamento de exceções, criando pontos de interrupção e respondendo a eventos síncronos, enviados pelo DE.

Métodos na ordem de Vtable

A tabela a seguir mostra os métodos de IDebugEngine2.

Método

Descrição

IDebugEngine2::EnumPrograms

Cria um enumerador para todos os programas que estiver sendo depurado por um DE.

IDebugEngine2::Attach

Anexa um DE um programa.

IDebugEngine2::CreatePendingBreakpoint

Cria um ponto de interrupção pendente DE.

IDebugEngine2::SetException

Especifica como o DE deve lidar com uma determinada exceção.

IDebugEngine2::RemoveSetException

Remove a exceção especificada para que ele não é mais tratado pelo mecanismo de depuração.

IDebugEngine2::RemoveAllSetExceptions

Remove a lista de exceções, que o IDE tiver definido para um idioma ou a arquitetura específica de tempo de execução.

IDebugEngine2::GetEngineID

Obtém a GUID do DE.

IDebugEngine2::DestroyProgram

Informa ao evento de destruir um DE que o programa especificado foi finalizado atypically e que o DE deve limpar todas as referências para o programa e enviar um programa.

IDebugEngine2::ContinueFromSynchronousEvent

Chamado pelo SDM para indicar que um evento de depuração síncrona, enviado pelo DE anteriormente para o SDM, foi recebido e processado.

IDebugEngine2::SetLocale

Define a localidade de.

IDebugEngine2::SetRegistryRoot

Define a raiz do registro atualmente em uso por DE.

IDebugEngine2::SetMetric

Define uma métrica.

IDebugEngine2::CauseBreak

Solicitações que todos os programas que estiver sendo depurados por este DE interromper a execução da próxima vez que um dos seus segmentos tenta executar.

Requisitos

Cabeçalho: Msdbg.h

Namespace: Microsoft.VisualStudio.Debugger.Interop

Assembly: Microsoft.VisualStudio.Debugger.Interop.dll

Consulte também

Referência

IDebugEventCallback2::Event

IDebugEngineCreateEvent2::GetEngine