IDebugRegisters2::GetValue method (dbgeng.h)

The GetValue method gets the value of one of the target's registers.

Syntax

HRESULT GetValue(
  [in]  ULONG        Register,
  [out] PDEBUG_VALUE Value
);

Parameters

[in] Register

Specifies the index of the register whose value is requested.

[out] Value

Receives the value of the register. See DEBUG_VALUE for a description of this parameter type.

Return value

This list does not contain all the errors that might occur. For a list of possible errors, see HRESULT Values.

Return code Description
S_OK
The method was successful.
E_UNEXPECTED
The target is not accessible, or the register could not be accessed.
E_INVALIDARG
The value of Register is greater than the number of registers on the target machine.

Remarks

To receive the values of multiple registers, use the GetValues method instead.

For an overview of the IDebugRegisters interface and other register-related methods, see Registers.

Requirements

Requirement Value
Target Platform Desktop
Header dbgeng.h (include DbgEng.h)

See also

GetValues

GetValues2

IDebugRegisters

IDebugRegisters2