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

Статья
02/23/2024

Метод 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, модуль указывается в параметре Base.

[in] Base

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

[out, optional] ImageNameBuffer

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

[in] ImageNameBufferSize

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

[out, optional] ImageNameSize

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

[out, optional] ModuleNameBuffer

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

[in] ModuleNameBufferSize

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

[out, optional] ModuleNameSize

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

[out, optional] LoadedImageNameBuffer

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

[in] LoadedImageNameBufferSize

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

[out, optional] LoadedImageNameSize

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

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

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

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