IDebugMessageEvent2

调试引擎使用此接口将消息发送到需要用户响应的 Visual Studio。

语法

IDebugMessageEvent2 : IUnknown

实现者须知

DE 实现此接口以向需要用户响应的 Visual Studio 发送消息。 必须在与此接口相同的对象上实现 IDebugEvent2 接口。 SDM 使用 QueryInterface 访问 IDebugEvent2 接口。

此接口的实现必须将 Visual Studio 对 SetResponse 的调用传达给 DE。 例如,这可以通过发布到 DE 的消息处理线程来完成,或者实现此接口的对象可以保存对 DE 的引用,并通过传入的 IDebugMessageEvent2::SetResponse响应回调 DE。

对调用者的说明

DE 创建并发送此事件对象,以向用户显示需要响应的消息。 事件通过使用 SDM 在被调试的程序附加时提供的 IDebugEventCallback2 回调函数发送。

Vtable 顺序中的方法

下表显示了 IDebugMessageEvent2 方法。

方法 说明
GetMessage 获取要显示的消息。
SetResponse 设置消息框中的响应(如果有)。

注解

如果 DE 需要特定消息的用户的特定响应,则 DE 将使用此接口。 例如,如果 DE 在尝试远程附加到程序后收到“拒绝访问”消息,则 DE 会在消息框样式MB_RETRYCANCEL为事件中IDebugMessageEvent2将此特定消息发送到 Visual Studio。 这样,用户就可以重试或取消附加操作。

DE 指定按照 Win32 函数 MessageBox 约定处理此消息的方式(有关详细信息,请参阅 AfxMessageBox )。

使用 IDebugErrorEvent2 接口将消息发送到不需要用户响应的 Visual Studio。

要求

标头:msdbg.h

命名空间:Microsoft.VisualStudio.Debugger.Interop

程序集:Microsoft.VisualStudio.Debugger.Interop.dll

另请参阅