Share via


IDebugMessageEvent2

El motor de depuración (DE) usa esta interfaz para enviar un mensaje a Visual Studio que requiere una respuesta del usuario.

Sintaxis

IDebugMessageEvent2 : IUnknown

Notas para los implementadores

El DE implementa esta interfaz para enviar un mensaje a Visual Studio que requiere una respuesta de usuario. La interfaz IDebugEvent2 debe implementarse en el mismo objeto que esta interfaz. SdM usa QueryInterface para acceder a la IDebugEvent2 interfaz.

La implementación de esta interfaz debe comunicar la llamada de Visual Studio de SetResponse al DE. Por ejemplo, esto puede hacerse con un mensaje publicado en el subproceso de control de mensajes del DE, o bien el objeto que implementa esta interfaz podría contener una referencia al DE y volver a llamar al DE con la respuesta pasada a IDebugMessageEvent2::SetResponse.

Notas para autores de la llamada

El DE crea y envía este objeto de evento para mostrar un mensaje al usuario que requiere una respuesta. El evento se envía mediante la función de devolución de llamada IDebugEventCallback2 proporcionada por el SDM cuando se adjunta al programa que se está depurando.

Métodos en orden de Vtable

En la tabla siguiente se muestran los métodos de IDebugMessageEvent2.

Método Descripción
GetMessage Obtiene el mensaje que se va a mostrar.
SetResponse Establece la respuesta, si existe, desde el cuadro de mensaje.

Comentarios

El DE usará esta interfaz si requiere una respuesta específica del usuario para un mensaje determinado. Por ejemplo, si el DE obtiene un mensaje "Acceso denegado" después de un intento de adjuntar remotamente a un programa, el DE envía este mensaje concreto a Visual Studio en un IDebugMessageEvent2 evento con el estilo MB_RETRYCANCELdel cuadro de mensaje . Esto permite al usuario reintentar o cancelar la operación de asociación.

El DE especifica cómo se va a controlar este mensaje siguiendo las convenciones de la función MessageBox Win32 (consulta AfxMessageBox para obtener más información).

Use la interfaz IDebugErrorEvent2 para enviar mensajes a Visual Studio que no requieren una respuesta del usuario.

Requisitos

Encabezado: msdbg.h

Espacio de nombres: Microsoft.VisualStudio.Debugger.Interop

Ensamblado: Microsoft.VisualStudio.Debugger.Interop.dll

Consulte también