Método IDebugSymbols::GetModuleNames (dbgeng.h)

El método GetModuleNames devuelve los nombres del módulo especificado.

Sintaxis

HRESULT GetModuleNames(
  [in]            ULONG   Index,
  [in]            ULONG64 Base,
  [out, optional] PSTR    ImageNameBuffer,
  [in]            ULONG   ImageNameBufferSize,
  [out, optional] PULONG  ImageNameSize,
  [out, optional] PSTR    ModuleNameBuffer,
  [in]            ULONG   ModuleNameBufferSize,
  [out, optional] PULONG  ModuleNameSize,
  [out, optional] PSTR    LoadedImageNameBuffer,
  [in]            ULONG   LoadedImageNameBufferSize,
  [out, optional] PULONG  LoadedImageNameSize
);

Parámetros

[in] Index

Especifica el índice del módulo cuyos nombres se solicitan. Si se establece en DEBUG_ANY_ID, el módulo se especifica mediante Base.

[in] Base

Especifica la dirección base del módulo cuyos nombres se solicitan. Este parámetro solo se usa si index está establecido en DEBUG_ANY_ID.

[out, optional] ImageNameBuffer

Recibe el nombre de la imagen del módulo. Si ImageNameBuffer es NULL, no se devuelve esta información.

[in] ImageNameBufferSize

Especifica el tamaño en caracteres del búfer ImageNameBuffer en caracteres. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] ImageNameSize

Recibe el tamaño en caracteres del nombre de la imagen. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si imageNameSize es null, esta información no se devuelve.

[out, optional] ModuleNameBuffer

Recibe el nombre del módulo del módulo. Si ModuleNameBuffer es null, no se devuelve esta información.

[in] ModuleNameBufferSize

Especifica el tamaño en caracteres del búfer ModuleNameBuffer. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] ModuleNameSize

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 moduleNameSize es NULL, no se devuelve esta información.

[out, optional] LoadedImageNameBuffer

Recibe el nombre de imagen cargado del módulo. Si loadedImageNameBuffer es NULL, esta información no se devuelve.

[in] LoadedImageNameBufferSize

Especifica el tamaño en caracteres del búfer LoadedImageNameBuffer. Este tamaño incluye el espacio para el carácter de terminación '\0'.

[out, optional] LoadedImageNameSize

Recibe el tamaño en caracteres del nombre de la imagen cargada. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si LoadedImageNameSize es NULL, no se devuelve esta información.

Valor devuelto

Este método también puede devolver otros valores de error. Consulte valores devueltos para obtener más información.

Código devuelto	Descripción
S_OK	El método se realizó correctamente.
S_FALSE	El método se realizó correctamente. Sin embargo, al menos una de ImageNameBuffer, ModuleNameBuffer, o LoadedImageNameBuffer era demasiado pequeña para el nombre correspondiente, por lo que se truncaba.
E_NOINTERFACE	No se encontró el módulo especificado.

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)

Consulte también

GetModuleNameString

IDebugSymbols

IDebugSymbols2

IDebugSymbols3