Метод IDebugSymbols3::GetSymbolEntryOffsetRegions (dbgeng.h)

  • Статья

Возвращает все области памяти, которые, как известно, связаны с символом.

Синтаксис

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

Параметры

[in] Id

Идентификатор модуля в виде указателя на структуру DEBUG_MODULE_AND_ID .

[in] Flags

Битовый набор, содержащий параметры, влияющие на поведение этого метода.

[out] Regions

Области памяти, связанные с символом.

[in] RegionsCount

Число областей, связанных с символом.

[out, optional] RegionsAvail

Указатель на количество областей, доступных для символа.

Возвращаемое значение

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Эта функция возвращает все известные области памяти, связанные с указанным символом. Простые символы имеют единую область, которая начинается с их основания. Более сложные регионы, такие как функции с несколькими областями кода, могут иметь произвольно большое количество регионов.

Качество возвращаемой информации в значительной степени зависит от доступной символьной информации.

Требования

Требование Значение
Целевая платформа Windows
Header dbgeng.h (включая Dbgeng.h)

См. также раздел

DEBUG_MODULE_AND_ID

IDebugSymbols3

IDebugSymbols3::GetSourceEntryOffsetRegions