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 até a configuração e limpeza de exceções.
Sintaxe
IDebugEngine2 : IUnknown
Notas para implementadores
Essa interface é implementada por um DE personalizado para gerenciar a depuração de programas. Essa interface deve ser implementada pelo DE.
Observações para chamadores
Essa interface é chamada pelo gerenciador de depuração de sessão (SDM) para gerenciar a sessão de depuração, incluindo o gerenciamento de exceções, a criação de pontos de interrupção e a resposta a eventos síncronos enviados pela DE.
Métodos na ordem VTable
A tabela a seguir mostra os métodos de IDebugEngine2.
| Método | Descrição |
|---|---|
| EnumPrograms | Cria um enumerador para todos os programas que estão sendo depurados por um DE. |
| Attach | Anexa um DE a um programa. |
| CreatePendingBreakpoint | Cria um ponto de interrupção pendente no DE. |
| SetException | Especifica como o DE deve lidar com uma determinada exceção. |
| RemoveSetException | Remove a exceção especificada para que ela não seja mais manipulada pelo mecanismo de depuração. |
| RemoveAllSetExceptions | Remove a lista de exceções que o IDE definiu para uma determinada arquitetura ou linguagem de tempo de execução. |
| GetEngineID | Obtém o GUID do DE. |
| DestroyProgram | Informa a um DE que o programa especificado foi encerrado atipicamente e que o DE deve limpar todas as referências ao programa e enviar um evento de destruição do programa. |
| ContinueFromSynchronousEvent | Chamado pelo SDM para indicar que um evento de depuração síncrona, enviado anteriormente pelo DE para o SDM, foi recebido e processado. |
| SetLocale | Define a localidade do DE. |
| SetRegistryRoot | Define a raiz do Registro atualmente em uso pelo DE. |
| SetMetric | Define uma métrica. |
| CauseBreak | Solicita que todos os programas que estão sendo depurados por esse DE interrompam a execução na próxima vez que um de seus threads tentar ser executado. |
Requisitos
Cabeçalho: Msdbg.h
Espaço para nome: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll