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