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

  • Artículo

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

Sintaxis

HRESULT GetModuleByModuleName2Wide(
  [in]            PCWSTR   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 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, 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.

Requisitos

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

Consulte también

GetModuleByModuleName

IDebugSymbols3