Método IDebugSymbols3::GetModuleNameString (dbgeng.h)
El método GetModuleNameString devuelve el nombre del módulo especificado.
Sintaxis
HRESULT GetModuleNameString(
[in] ULONG Which,
[in] ULONG Index,
[in] ULONG64 Base,
[out, optional] PSTR Buffer,
[in] ULONG BufferSize,
[out, optional] PULONG NameSize
);
Parámetros
[in] Which
Especifica cuál de los nombres del módulo que se van a devolver, los valores posibles son:
| Valor | Descripción |
|---|---|
| DEBUG_MODNAME_IMAGE | Nombre de la imagen. Este es el nombre del archivo ejecutable, incluida la extensión . Normalmente, la ruta de acceso completa se incluye en modo de usuario, pero no en modo kernel. |
| DEBUG_MODNAME_MODULE | Nombre del módulo. Normalmente, este es solo el nombre de archivo sin la extensión. En algunos casos, el nombre del módulo difiere significativamente del nombre de archivo. |
| DEBUG_MODNAME_LOADED_IMAGE | Nombre de la imagen cargada. A menos que los símbolos de Microsoft CodeView estén presentes, este es el mismo que el nombre de la imagen. |
| DEBUG_MODNAME_SYMBOL_FILE | Nombre del archivo de símbolos. Ruta de acceso y nombre del archivo de símbolos. Si no se han cargado símbolos, este es el nombre del archivo ejecutable en su lugar. |
| DEBUG_MODNAME_MAPPED_IMAGE | Nombre de la imagen asignada. En la mayoría de los casos, esto es NULL. Si el depurador asigna un archivo de imagen (por ejemplo, durante la depuración de minivolcados), este es el nombre de la imagen asignada. |
[in] Index
Especifica el índice del módulo. Si se establece en DEBUG_ANY_ID, el parámetro Base se usa para especificar la ubicación del módulo en su lugar.
[in] Base
Si index es DEBUG_ANY_ID, especifica la ubicación en el espacio de direcciones de memoria del destino de la base del módulo. De lo contrario, se omite.
[out, optional] Buffer
Recibe el nombre del módulo. Si de búfer es NULL, no se devuelve esta información.
[in] BufferSize
Especifica el tamaño en caracteres del búfer Búfer. Este tamaño incluye el espacio para el carácter de terminación '\0'.
[out, optional] NameSize
Recibe el tamaño en caracteres del nombre del módulo. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si NameSize es null, no se devuelve esta información.
Valor devuelto
Este método también puede devolver valores de error. Consulte valores devueltos para obtener más información.
| Código devuelto | Descripción |
|---|---|
|
El método se realizó correctamente. |
|
El método se realizó correctamente. Sin embargo, el tamaño del búfer era menor que el tamaño del nombre del módulo, por lo que se truncaba para caber en el búfer. |
Observaciones
Para obtener más información sobre los módulos, consulte Modules.
Requisitos
| Requisito | Valor |
|---|---|
| de la plataforma de destino de | Escritorio |
| encabezado de | dbgeng.h (include Dbgeng.h) |