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

El método GetModuleByModuleName busca en los módulos de destino para uno 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 Nombre. Si index es NULL, no se devuelve esta información.

[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, 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.
E_INVALIDARG	Uno de los argumentos pasados no era válido.

Observaciones

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, los módulos posteriores se pueden encontrar mediante llamadas repetidas a estos métodos con valores más altos de StartIndex.

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

GetModuleByModuleName2

IDebugSymbols

IDebugSymbols2

IDebugSymbols3