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

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

  • Статья

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

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

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

[out, optional] Index

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

[out, optional] Base

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

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

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

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

Комментарии

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

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

Требования

Требование Значение
Целевая платформа Персональный компьютер
Верхняя часть dbgeng.h (включая Dbgeng.h)

См. также раздел

GetModuleByModuleName

IDebugSymbols3