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

Метод GetModuleNames возвращает имена указанного модуля.

Синтаксис

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

Параметры

[in] Index

Указывает индекс модуля, имена которого запрашиваются. Если для него задано значение DEBUG_ANY_ID, модуль указывается Базовым.

[in] Base

Указывает базовый адрес модуля, имена которого запрашиваются. Этот параметр используется только в том случае, если индекс имеет значение DEBUG_ANY_ID.

[out, optional] ImageNameBuffer

Получает имя образа модуля. Если ImageNameBufferNULL, эти сведения не возвращаются.

[in] ImageNameBufferSize

Задает размер символов буфера ImageNameBuffer в символах. Этот размер включает пробел для завершающего символа \0.

[out, optional] ImageNameSize

Получает размер в символах имени изображения. Этот размер включает пробел для завершающего символа \0. Если ImageNameSizeNULL, эти сведения не возвращаются.

[out, optional] ModuleNameBuffer

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

[in] ModuleNameBufferSize

Задает размер символов буфера ModuleNameBuffer. Этот размер включает пробел для завершающего символа \0.

[out, optional] ModuleNameSize

Получает размер в символах имени модуля. Этот размер включает пробел для завершающего символа \0. Если ModuleNameSizeNULL, эти сведения не возвращаются.

[out, optional] LoadedImageNameBuffer

Получает загруженное имя образа модуля. Если LoadedImageNameBufferNULL, эти сведения не возвращаются.

[in] LoadedImageNameBufferSize

Задает размер символов буфера LoadedImageNameBuffer. Этот размер включает пробел для завершающего символа \0.

[out, optional] LoadedImageNameSize

Получает размер символов загруженного имени изображения. Этот размер включает пробел для завершающего символа \0. Если LoadedImageNameSizenull, эти сведения не возвращаются.

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

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

Возвращаемый код Описание
S_OK
Метод был успешным.
S_FALSE
Метод был успешным. Однако хотя бы один из ImageNameBuffer, ModuleNameBufferили LoadedImageNameBuffer был слишком мал для соответствующего имени, поэтому он был усечен.
E_NOINTERFACE
Указанный модуль не найден.

Замечания

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

Требования

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

См. также

GetModuleNameString

IDebugSymbols

IDebugSymbols2

IDebugSymbols3