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

Artículo
08/07/2023

El método GetModuleByOffset2 busca en los módulos del proceso uno cuya asignación de memoria incluya la ubicación especificada.

Sintaxis

HRESULT GetModuleByOffset2(
  [in]            ULONG64  Offset,
  [in]            ULONG    StartIndex,
  [in]            ULONG    Flags,
  [out, optional] PULONG   Index,
  [out, optional] PULONG64 Base
);

Parámetros

[in] Offset

Especifica una ubicación en el espacio de direcciones virtuales del destino que está dentro de la asignación de memoria del módulo deseado; por ejemplo, la dirección de un símbolo que pertenece al módulo.

[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 la ubicación especificada. 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 módulo. 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 valores de error. Consulte Valores devueltos para obtener más detalles.

Código devuelto	Descripción
S_OK	Método realizado correctamente.

Comentarios

A partir del índice especificado, este método devuelve el primer módulo que encuentra cuyo intervalo de direcciones de asignación de memoria incluye la ubicación especificada. Si el destino tiene más de un módulo cuyo intervalo de direcciones de memoria incluye esta ubicación, se pueden encontrar módulos posteriores mediante llamadas repetidas a este método con valores más altos de StartIndex.

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