Edit

IDebugSymbols3::GetSourceEntryOffsetRegions method (dbgeng.h)

  • Article

Returns all memory regions known to be associated with a source entry.

Syntax

HRESULT GetSourceEntryOffsetRegions(
  [in]            PDEBUG_SYMBOL_SOURCE_ENTRY Entry,
  [in]            ULONG                      Flags,
  [out]           PDEBUG_OFFSET_REGION       Regions,
  [in]            ULONG                      RegionsCount,
  [out, optional] PULONG                     RegionsAvail
);

Parameters

[in] Entry

An entry as a DEBUG_SYMBOL_SOURCE_ENTRY structure.

[in] Flags

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

[out] Regions

The memory regions associated with the source entry.

[in] RegionsCount

The number of regions associated with the entry.

[out, optional] RegionsAvail

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

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 source entry. 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.

Requirements

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

See also

DEBUG_SYMBOL_SOURCE_ENTRY

IDebugSymbols3

IDebugSymbols3::GetSymbolEntryOffsetRegions