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

Статья
08/07/2023

Метод GetModuleByOffset выполняет поиск в модулях целевого объекта, где выделенная память включает указанное расположение.

Синтаксис

HRESULT GetModuleByOffset(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Параметры

[in] Offset

Указывает расположение в виртуальном адресном пространстве целевого объекта, которое находится внутри выделения памяти нужного модуля, например адрес символа, принадлежащего модулю.

[in] StartIndex

Указывает индекс для начала поиска.

[out, optional] Index

Получает индекс модуля. Если параметр Index имеет значение NULL, эта информация не возвращается.

[out, optional] Base

Получает расположение в адресном пространстве целевой памяти базы модуля. Если base имеет значение NULL, эти сведения не возвращаются.

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

Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в разделе Возвращаемые значения .

Код возврата	Описание
S_OK	Метод выполнен успешно.

Начиная с указанного индекса этот метод возвращает первый модуль, который он находит, диапазон адресов выделения памяти которого включает указанное расположение. Если целевой объект содержит несколько модулей, диапазон адресов памяти которых включает это расположение, последующие модули можно найти с помощью повторных вызовов этого метода с более высокими значениями StartIndex.

Дополнительные сведения о модулях см. в разделе Модули.