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

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

Sintaxis

HRESULT GetModuleByModuleName2(
  [in]            PCSTR    Name,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [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.

[in] Flags

Especifica un conjunto de bits que contiene opciones que se usan al buscar el módulo con el nombre especificado. Marcas puede contener las marcas de bits siguientes:

Bandera	Efecto
DEBUG_GETMOD_NO_LOADED_MODULES	No busque los módulos cargados.
DEBUG_GETMOD_NO_UNLOADED_MODULES	No busque los módulos descargados.

[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

GetModuleByModuleName

IDebugSymbols3