IDebugMessageEvent2
Essa interface é usada pelo mecanismo de depuração (DE) para enviar uma mensagem para o Visual Studio que requer uma resposta do usuário.
Sintaxe
IDebugMessageEvent2 : IUnknown
Notas para implementadores
O DE implementa essa interface para enviar uma mensagem para o Visual Studio que requer uma resposta do usuário. 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 Visual Studio de SetResponse para o DE. Por exemplo, isso pode ser feito com uma mensagem postada no thread de manipulação de mensagens do DE, ou o objeto que implementa essa interface pode conter uma referência ao DE e chamar de volta para o DE com a resposta passada para IDebugMessageEvent2::SetResponseo .
Observações para chamadores
O DE cria e envia esse objeto de evento para exibir uma mensagem ao usuário que requer uma resposta. O evento é enviado usando a função de retorno de chamada IDebugEventCallback2 que é fornecida pelo SDM quando ele é anexado ao programa que está sendo depurado.
Métodos na ordem VTable
A tabela a seguir mostra os métodos de IDebugMessageEvent2.
| Método | Descrição |
|---|---|
| GetMessage | Faz com que a mensagem seja exibida. |
| SetResponse | Define a resposta, se houver, da caixa de mensagem. |
Comentários
O DE usará essa interface se exigir uma resposta específica do usuário para uma mensagem específica. Por exemplo, se o DE obtém uma mensagem "Acesso negado" após uma tentativa de anexar remotamente a um programa, o DE envia essa mensagem específica para o Visual Studio em um IDebugMessageEvent2 evento com o estilo MB_RETRYCANCELde caixa de mensagem . Isso permite que o usuário tente novamente ou cancele a operação de anexação.
O DE especifica como essa mensagem deve ser tratada seguindo as convenções da função MessageBox Win32 (consulte AfxMessageBox para obter detalhes).
Use a interface IDebugErrorEvent2 para enviar mensagens para o Visual Studio que não exigem uma resposta do usuário.
Requisitos
Cabeçalho: msdbg.h
Espaço para nome: Microsoft.VisualStudio.Debugger.Interop
Assembly: Microsoft.VisualStudio.Debugger.Interop.dll