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

Статья
02/23/2024

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

Синтаксис

HRESULT GetModuleNameString(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    Buffer,
  [in]            ULONG   BufferSize,
  [out, optional] PULONG  NameSize
);

Параметры

[in] Which

Указывает, какие из возвращаемых имен модуля могут быть следующими:

Значение	Описание
DEBUG_MODNAME_IMAGE	Имя изображения. Это имя исполняемого файла, включая расширение . Как правило, полный путь включается в пользовательском режиме, но не в режиме ядра.
DEBUG_MODNAME_MODULE	Имя модуля. Обычно это просто имя файла без расширения. В некоторых случаях имя модуля значительно отличается от имени файла.
DEBUG_MODNAME_LOADED_IMAGE	Имя загруженного образа. Если символы Microsoft CodeView отсутствуют, это то же самое, что и имя изображения.
DEBUG_MODNAME_SYMBOL_FILE	Имя файла символов. Путь и имя файла символов. Если символы не загружены, это имя исполняемого файла.
DEBUG_MODNAME_MAPPED_IMAGE	Имя сопоставленного образа. В большинстве случаев это ЗНАЧЕНИЕ РАВНО NULL. Если отладчик сопоставляет файл изображения (например, во время отладки minidump), это имя сопоставленного образа.

[in] Index

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

[in] Base

Если параметр Index имеет DEBUG_ANY_ID, указывает расположение в целевом адресном пространстве памяти базы модуля. В противном случае он игнорируется.

[out, optional] Buffer

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

[in] BufferSize

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

[out, optional] NameSize

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

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

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

Код возврата	Описание
S_OK	Метод выполнен успешно.
S_FALSE	Метод выполнен успешно. Однако размер буфера был меньше, чем размер имени модуля, поэтому он был усечен для размещения в буфере.

Требования

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

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

GetModuleNames

IDebugSymbols2

IDebugSymbols3