IDebugSymbols2::GetModuleByOffset-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetModuleByOffset Methode durchsucht die Module des Ziels nach einem Modul, dessen Speicherzuweisung den angegebenen Speicherort enthält.

Syntax

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

Parameter

[in] Offset

Gibt einen Speicherort im virtuellen Adressraum des Ziels an, der sich innerhalb der Speicherzuweisung des gewünschten Moduls befindet , z. B. die Adresse eines Symbols, das zum Modul gehört.

[in] StartIndex

Gibt den Index an, von dem die Suche gestartet werden soll.

[out, optional] Index

Empfängt den Index des Moduls. Wenn Index-NULL-ist, werden diese Informationen nicht zurückgegeben.

[out, optional] Base

Empfängt den Speicherort im Speicheradressbereich des Ziels der Basis des Moduls. Wenn Base-NULL-ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.

Bemerkungen

Beginnend mit dem angegebenen Index gibt diese Methode das erste Modul zurück, das gefunden wird, dessen Speicherzuordnungsadressenbereich den angegebenen Speicherort enthält. Wenn das Ziel mehrere Module enthält, deren Speicheradressbereich diesen Speicherort enthält, können nachfolgende Module durch wiederholte Aufrufe dieser Methode mit höheren Werten von StartIndex-gefunden werden.

Weitere Informationen zu Modulen finden Sie unter Module.