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

Статья
06.02.2025

Метод GetModuleByModuleName2 выполняет поиск по модулям процесса для одного с указанным именем.

Синтаксис

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

Параметры

[in] Name

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

[in] StartIndex

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

[in] Flags

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

Флаг	Эффект
DEBUG_GETMOD_NO_LOADED_MODULES	Не искать загруженные модули.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Не искать выгруженные модули.

[out, optional] Index

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

[out, optional] Base

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

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

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

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

Замечания

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

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

Требования

Требование	Ценность
целевая платформа	Настольный
заголовка	dbgeng.h (include Dbgeng.h)

См. также

GetModuleByModuleName

IDebugSymbols3

Поделиться через