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

另請參閱