Método IDebugSymbols3::GetModuleNameStringWide (dbgeng.h)

El método GetModuleNameStringWide devuelve el nombre del módulo especificado.

Sintaxis

HRESULT GetModuleNameStringWide(
  [in]            ULONG   Which,
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PWSTR   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

   
Plataforma de destino Escritorio
Header dbgeng.h (include Dbgeng.h)

Consulte también

GetModuleNames

IDebugSymbols3