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

Статья
08/07/2023

Метод GetModuleByModuleName выполняет поиск в модулях целевого объекта с указанным именем.

Синтаксис

HRESULT GetModuleByModuleName(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Параметры

[in] Name

Указывает имя нужного модуля.

[in] StartIndex

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

[out, optional] Index

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

[out, optional] Base

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

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

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

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

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

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