IDebugSymbols3::GetModuleNameStringWide method (dbgeng.h)
The GetModuleNameStringWide method returns the name of the specified module.
HRESULT GetModuleNameStringWide( [in] ULONG Which, [in] ULONG Index, [in] ULONG64 Base, [out, optional] PWSTR Buffer, [in] ULONG BufferSize, [out, optional] PULONG NameSize );
Specifies which of the module's names to return, possible values are:
|DEBUG_MODNAME_IMAGE||The image name. This is the name of the executable file, including the extension. Typically, the full path is included in user mode but not in kernel mode.|
|DEBUG_MODNAME_MODULE||The module name. This is usually just the file name without the extension. In a few cases, the module name differs significantly from the file name.|
|DEBUG_MODNAME_LOADED_IMAGE||The loaded image name. Unless Microsoft CodeView symbols are present, this is the same as the image name.|
|DEBUG_MODNAME_SYMBOL_FILE||The symbol file name. The path and name of the symbol file. If no symbols have been loaded, this is the name of the executable file instead.|
|DEBUG_MODNAME_MAPPED_IMAGE||The mapped image name. In most cases, this is NULL. If the debugger is mapping an image file (for example, during minidump debugging), this is the name of the mapped image.|
Specifies the index of the module. If it is set to DEBUG_ANY_ID, the Base parameter is used to specify the location of the module instead.
If Index is DEBUG_ANY_ID, specifies the location in the target's memory address space of the base of the module. Otherwise it is ignored.
[out, optional] Buffer
Receives the name of the module. If Buffer is NULL, this information is not returned.
Specifies the size in characters of the buffer Buffer. This size includes the space for the '\0' terminating character.
[out, optional] NameSize
Receives the size in characters of the module's name. This size includes the space for the '\0' terminating character. If NameSize is NULL, this information is not returned.
This method may also return error values. See Return Values for more details.
||The method was successful.|
||The method was successful. However, the size of the buffer was smaller than the size of the module's name so it was truncated to fit in the buffer.|
For more information about modules, see Modules.
|Header||dbgeng.h (include Dbgeng.h)|
Submit and view feedback for