ICorDebugMutableDataTarget Interface

Extends the ICorDebugDataTarget interface to support mutable data targets.

Methods

Method Description
ContinueStatusChanged Method Changes the continuation status for the outstanding debug event on the specified thread.
SetThreadContext Method Sets the context (register values) for a thread.
WriteVirtual Method Writes memory into the target process address space.

Remarks

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. Any failure HRESULT from these methods will propagate out as the HRESULT from the ICorDebug method call.

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). 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.

Header: CorDebug.idl, CorDebug.h

Library: CorGuids.lib

.NET Framework Versions: Available since 4.6

See also