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

Статья
02/23/2024

Метод 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.

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