IDebugSymbols3::GetSymbolEntryOffsetRegions method (dbgeng.h)
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) |