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

Статья
08/07/2023

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

Синтаксис

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

Параметры

[in] Offset

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

[in] StartIndex

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

[in] Flags

Указывает битовый набор, содержащий параметры, используемые при поиске модуля с указанным расположением. Флаги могут содержать следующие битовые флаги:

Flag	Действие
DEBUG_GETMOD_NO_LOADED_MODULES	Не ищите загруженные модули.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Не выполняйте поиск по выгруженным модулям.

[out, optional] Index

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

[out, optional] Base

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

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

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

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

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

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