Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Метод GetModuleNameStringWide возвращает имя указанного модуля.
Синтаксис
HRESULT GetModuleNameStringWide(
[in] ULONG Which,
[in] ULONG Index,
[in] ULONG64 Base,
[out, optional] PWSTR 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
Если индекс DEBUG_ANY_ID, указывает расположение в адресном пространстве памяти целевого объекта базы модуля. В противном случае он игнорируется.
[out, optional] Buffer
Получает имя модуля. Если буферnull, эти сведения не возвращаются.
[in] BufferSize
Задает размер символов буфера буфера. Этот размер включает пробел для завершающего символа \0.
[out, optional] NameSize
Получает размер в символах имени модуля. Этот размер включает пробел для завершающего символа \0. Если NameSizeNULL, эти сведения не возвращаются.
Возвращаемое значение
Этот метод также может возвращать значения ошибок. Дополнительные сведения см. в возвращаемых значений.
| Возвращаемый код | Описание |
|---|---|
|
Метод был успешным. |
|
Метод был успешным. Однако размер буфера был меньше размера имени модуля, поэтому он был усечен для размещения в буфере. |
Замечания
Дополнительные сведения о модулях см. в модулях.
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Настольный |
| заголовка | dbgeng.h (include Dbgeng.h) |