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

Artículo
02/26/2024

El método GetModuleByModuleName busca en uno los módulos del destino con el nombre especificado.

Sintaxis

HRESULT GetModuleByModuleName(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parámetros

[in] Name

Especifica el nombre del módulo deseado.

[in] StartIndex

Especifica el índice desde el que empezar a buscar.

[out, optional] Index

Recibe el índice del primer módulo con el nombre Name. Si Index es NULL, esta información no se devuelve.

[out, optional] Base

Recibe la ubicación en el espacio de direcciones de memoria del destino de la base del módulo. Si Base 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.
E_INVALIDARG	Uno de los argumentos pasados no era válido.

Comentarios

A partir del índice especificado, estos métodos devuelven el primer módulo que encuentran con el nombre especificado. Si el destino tiene más de un módulo con este nombre, se pueden encontrar módulos posteriores mediante llamadas repetidas a estos métodos con valores superiores de StartIndex.

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