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

Artículo
08/07/2023

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, base especifica el módulo.

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

[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. Este tamaño incluye el espacio para el carácter de terminación '\0'. Si ModuleNameBuffer es NULL, esta información no se devuelve.

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

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

Valor devuelto

Este método también puede devolver otros 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, al menos uno de ImageNameBuffer, ModuleNameBuffer o LoadedImageNameBuffer era demasiado pequeño para el nombre correspondiente, por lo que se truncaba.
E_NOINTERFACE	No se encontró el módulo especificado.