Debugging Tools for Windows

GetSymbolRegister

The GetSymbolRegister method returns the register that contains the value or a pointer to the value of a symbol in a symbol group.

HRESULT
  IDebugSymbolGroup2::GetSymbolRegister(
    IN ULONG  Index,
    OUT PULONG  Register
    );

Parameters

Index
The index of the symbol to return the register for. The index of a symbol is an identification number. The index ranges from zero through the number of symbols in the symbol group minus one.
Register
The index of the register that contains the value or a pointer to the value of the symbol.

Return Value

GetSymbolRegister might return one of the following values:

S_OK
The method was successful.
E_NOINTERFACE
The symbol's value and a pointer to it are not contained in a register, or the register is not known.

This method might also return error values. For more information about possible return values, see Return Values.

Comments

For more information about symbol groups, see Scopes and Symbol Groups. For more information about registers and the register index, see Registers.

Requirements

Versions: Available in IDebugSymbolGroup2 and later versions.

Headers: Defined in Dbgeng.h. Include Dbgeng.h.

See Also

GetNumberSymbols

Build machine: CAPEBUILD