Debugging Tools for Windows |
The SetValues method sets the value of several of the target's registers.
HRESULT
IDebugRegisters::SetValues(
IN ULONG Count,
IN OPTIONAL PULONG Indices,
IN ULONG Start,
IN PDEBUG_VALUE Values
);
This list does not contain all the errors that might occur. For a list of possible errors, see HRESULT Values.
SetValues is available in all versions of IDebugRegisters.
The engine does its best to coerce the values in Values into the type of the registers; this coercion is the same as that performed by CoerceValue. If the value is larger than what the register can hold, the least significant bits are dropped. Floating-point and integer conversions will also be performed if necessary.
If the return value is not S_OK, some of the registers still might have been set.
When a subregister is altered, the register containing it is also altered.
To set the value of only a single register, use the SetValue method instead.
The method SetValues2 performs the same task as this method but also allows the register source to be specified.
For an overview of the IDebugRegisters interface and other register-related methods, see Registers.
Headers: Defined in DbgEng.h. Include DbgEng.h.