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áles de los nombres del módulo que se van a devolver, los valores posibles son:

Valor	Descripción
DEBUG_MODNAME_IMAGE	El 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 está asignando 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, se usa el parámetro Base 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 El búfer es NULL, esta información no se devuelve.

[in] BufferSize

Especifica el tamaño en caracteres del búfer de 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, esta información no se devuelve.

Valor devuelto

Este método también puede devolver valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.
S_FALSE	Método realizado 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.

Comentarios

Para obtener más información sobre los módulos, consulte Módulos.

Requisitos

Requisito	Value
Plataforma de destino	Escritorio
Encabezado	dbgeng.h (include Dbgeng.h)

Consulte también

GetModuleNames

IDebugSymbols2

IDebugSymbols3