IDebugMessageEvent2

Artigo
05/17/2015

Essa interface é usada pelo mecanismo de depuração (DE) para enviar uma mensagem para Visual Studio que requer uma resposta do usuário.

IDebugMessageEvent2 : IUnknown

Observações para Implementadores

O DE implementa essa interface para enviar uma mensagem para Visual Studio que requer uma resposta do usuário. O IDebugEvent2 interface deve ser implementada no mesmo objeto dessa interface. O SDM usa QueryInterface para acesso a IDebugEvent2 interface.

A implementação desta interface deve comunicar a chamada do Visual Studio de IDebugMessageEvent2::SetResponse para o DE. Por exemplo, isso pode ser feito com uma mensagem postada a mensagem da DE segmento de tratamento, ou o objeto que implementa essa interface poderia manter uma referência DE e retorno de chamada para o DE com a resposta passada para IDebugMessageEvent2::SetResponse.

Observações para chamadores

O DE cria e envia este objeto de evento para exibir uma mensagem para o usuário que requer uma resposta. O evento é enviado usando o IDebugEventCallback2 função de retorno de chamada que é fornecida pelo SDM quando ele está vinculado ao programa que está sendo depurado.

Métodos na ordem de Vtable

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

Método	Descrição
IDebugMessageEvent2::GetMessage	Obtém a mensagem a ser exibida.
IDebugMessageEvent2::SetResponse	Define a resposta, se houver, da caixa de mensagem.

Comentários

O DE usará essa interface, se ele requer uma resposta específica do usuário para uma determinada mensagem. Por exemplo, se o DE uma mensagem de "Acesso negado" após uma tentativa de se conectar remotamente a um programa, o DE envia a mensagem em questão para Visual Studio em um IDebugMessageEvent2 eventos com o estilo da caixa de mensagem MB_RETRYCANCEL. Isso permite ao usuário Repetir ou cancelar a operação de anexação.

O DE Especifica como esta mensagem deve ser tratado de acordo com as convenções da função Win32 MessageBox (consulte AfxMessageBox para obter detalhes).

Use o IDebugErrorEvent2 interface para enviar mensagens para Visual Studio que não exigem uma resposta do usuário.