Compartir a través de

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

  • Artículo

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

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 se va a empezar a buscar.

[in] Flags

Especifica un conjunto de bits que contiene las opciones usadas al buscar el módulo con el nombre especificado. Las marcas pueden contener las marcas de bits siguientes:

Marca 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 Name. 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 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 más altos de StartIndex.

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

Requisitos

Requisito Value
Plataforma de destino Escritorio
Encabezado dbgeng.h (incluir Dbgeng.h)

Consulte también

GetModuleByModuleName

IDebugSymbols3