Compartilhar via


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

Confira também