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

2025-02-06

Метод 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. Если индексnull, эти сведения не возвращаются.

[out, optional] Base

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

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

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

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

Замечания

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

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