Edit

IDebugSymbols3::GetSymbolEntryOffsetRegions method (dbgeng.h)

  • Article

Returns all the memory regions known to be associated with a symbol.

Syntax

HRESULT GetSymbolEntryOffsetRegions(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Flags,
  [out]           PDEBUG_OFFSET_REGION Regions,
  [in]            ULONG                RegionsCount,
  [out, optional] PULONG               RegionsAvail
);

Parameters

[in] Id

The ID of a module as a pointer to a DEBUG_MODULE_AND_ID structure.

[in] Flags

A bit-set that contains options that affect the behavior of this method.

[out] Regions

The memory regions associated with the symbol.

[in] RegionsCount

The number of regions associated with the symbol.

[out, optional] RegionsAvail

A pointer to the number of regions available to the symbol.

Return value

If this method succeeds, it returns S_OK. Otherwise, it returns an HRESULT error code.

This function returns all known memory regions that associated with a specified symbol. Simple symbols have a single region that starts from their base. More complicated regions, such as functions that have multiple code areas, can have an arbitrarily large number of regions.

The quality of information returned is highly dependent on the symbolic information available.

Requirements

Requirement Value
Target Platform Windows
Header dbgeng.h (include Dbgeng.h)

See also

DEBUG_MODULE_AND_ID

IDebugSymbols3

IDebugSymbols3::GetSourceEntryOffsetRegions