IDebugSymbols3::GetSourceEntryOffsetRegions method (dbgeng.h)

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

See also

DEBUG_SYMBOL_SOURCE_ENTRY

IDebugSymbols3

IDebugSymbols3::GetSymbolEntryOffsetRegions