IDebugCanStopEvent2
Essa interface é usada para perguntar ao gerenciador de depuração de sessão (SDM) se deve parar no local do código atual.
Sintaxe
IDebugCanStopEvent2 : IUknown
Notas para implementadores
O mecanismo de depuração (DE) implementa essa interface para oferecer suporte à passagem pelo código-fonte. A interface IDebugEvent2 deve ser implementada no mesmo objeto que essa interface (o SDM usa QueryInterface para acessar a IDebugEvent2 interface).
A implementação dessa interface deve comunicar a chamada do SDM do CanStop para o mecanismo de depuração. Por exemplo, isso pode ser feito com uma mensagem postada no thread de manipulação de mensagens do mecanismo de depuração ou o objeto que implementa essa interface pode conter uma referência ao mecanismo de depuração e chamar de volta para o mecanismo de depuração com o sinalizador passado para IDebugCanStopEvent2::CanStop.
Observações para chamadores
O DE pode enviar esse método cada vez que o DE é solicitado a continuar a execução e o DE está passando pelo código. Esse evento é enviado usando a função de retorno de chamada IDebugEventCallback2 fornecida pelo SDM quando ele se conectou ao programa que está sendo depurado.
Métodos na ordem VTable
A tabela a seguir mostra os métodos de IDebugCanStopEvent2.
| Método | Descrição |
|---|---|
| GetReason | Obtém o motivo deste evento. |
| CanStop | Especifica se o programa que está sendo depurado deve parar no local desse evento (e enviar um evento que descreva o motivo da parada) ou apenas continuar a execução. |
| GetDocumentContext | Obtém o contexto do documento que descreve o local desse evento. |
| GetCodeContext | Obtém o contexto de código que descreve o local desse evento. |
Comentários
O DE envia essa interface se o usuário entrar em uma função e o DE não encontrar nenhuma informação de depuração lá ou informações de depuração existirem, mas o DE não sabe se o código-fonte pode ser exibido para esse local.
Requisitos
Cabeçalho: msdbg.h
Espaço para nome: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll