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

Статья
08/07/2023

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

Получает имя модуля. Этот размер включает пробел для символа завершения "\0". Если 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	Указанный модуль не найден.