IDebugEngine2
這個介面代表偵錯引擎 (DE)。 它可用來管理偵錯會話的各個層面,從建立斷點到設定和清除例外狀況。
語法
IDebugEngine2 : IUnknown
實作者的注意事項
此介面是由自定義 DE 實作,以管理程式的偵錯。 DE 必須實作這個介面。
呼叫端注意事項
會話偵錯管理員 (SDM) 會呼叫此介面來管理偵錯會話,包括管理例外狀況、建立斷點,以及回應 DE 所傳送的同步事件。
依照 Vtable 順序的方法
下表顯示 IDebugEngine2
方法。
方法 | 描述 |
---|---|
EnumPrograms | 為 DE 偵錯的所有程式建立列舉值。 |
附加 | 將 DE 附加至程式。 |
CreatePendingBreakpoint | 在 DE 中建立暫止斷點。 |
SetException | 指定 DE 應該如何處理指定的例外狀況。 |
RemoveSetException | 拿掉指定的例外狀況,使其不再由偵錯引擎處理。 |
RemoveAllSetExceptions | 拿掉 IDE 針對特定執行時間架構或語言所設定的例外狀況清單。 |
GetEngineID | 取得 DE 的 GUID。 |
DestroyProgram | 通知 DE 指定的程式已暫時終止,而且 DE 應該清除程式的所有參考,並傳送程式終結事件。 |
ContinueFromSynchronousEvent | 由 SDM 呼叫,表示先前由 DE 傳送至 SDM 的同步偵錯事件已收到並處理。 |
SetLocale | 設定 DE 的地區設定。 |
SetRegistryRoot | 設定 DE 目前正在使用的登錄根目錄。 |
SetMetric | 設定計量。 |
CauseBreak | 要求此 DE 偵錯的所有程式會在下次嘗試執行其中一個線程時停止執行。 |
需求
標頭:Msdbg.h
命名空間:Microsoft.VisualStudio.Debugger.Interop
元件:Microsoft.VisualStudio.Debugger.Interop.dll