ICorDebugMutableDataTarget 介面ICorDebugMutableDataTarget Interface

擴充 ICorDebugDataTarget 介面,以支援可變數據目標。Extends the ICorDebugDataTarget interface to support mutable data targets.

方法Methods

方法Method 描述Description
ContinueStatusChanged 方法ContinueStatusChanged Method 變更指定執行緒上未處理之偵錯事件的接續狀態。Changes the continuation status for the outstanding debug event on the specified thread.
SetThreadContext 方法SetThreadContext Method 設定執行緒的內容 (登錄值)。Sets the context (register values) for a thread.
WriteVirtual 方法WriteVirtual Method 將記憶體寫入目標處理序位址空間。Writes memory into the target process address space.

備註Remarks

ICorDebugDataTarget介面的這個擴充功能可以藉由偵錯工具來執行,這些工具想要修改目標進程 (例如,用來執行即時的侵入式偵錯工具) 。This extension to the ICorDebugDataTarget interface can be implemented by debugging tools that wish to modify the target process (for example, to perform live invasive debugging).

上述所有方法都是選擇性的,未實作這個介面或無法呼叫這些方法,並不會失去以核心檢查為基礎的偵錯功能。All of these methods are optional in the sense that no core inspection-based debugging functionality is lost by not implementing this interface or by the failure of calls to these methods. 這些方法中的任何失敗 HRESULT 都會以 HRESULT 形式從 ICorDebug 方法呼叫向外傳播。Any failure HRESULT from these methods will propagate out as the HRESULT from the ICorDebug method call.

請注意,單一 ICorDebug 方法呼叫可能會導致多項變動,沒有任何機制可確保相關的變動會以交易方式 (全有或全無) 來套用。Note that a single ICorDebug method call may result in multiple mutations, and that there is no mechanism for ensuring related mutations are applied transactionally (all-or-none). 這表示如果某項變動在其他變動成功之後失敗 (在相同的 ICorDebug 呼叫中),目標處理序的狀態可能會不一致,因此偵錯可能會變成不可靠。This means that if a mutation fails after others (for the same ICorDebug call) have succeeded, the target process may be left in an inconsistent state and debugging may become unreliable.

規格需求Requirements

平台: 請參閱 系統需求Platforms: See System Requirements.

標頭: CorDebug.idl、CorDebug.hHeader: CorDebug.idl, CorDebug.h

程式庫: CorGuids.libLibrary: CorGuids.lib

.NET Framework 版本:自 4.6 起可用Available since 4.6.NET Framework Versions: 自 4.6 起可用Available since 4.6

另請參閱See also