IDebugSymbols3::GetModuleByOffset2-Methode (dbgeng.h)

Artikel
02/27/2024

Die GetModuleByOffset2-Methode durchsucht die Module des Prozesses nach einem Prozessmodul , dessen Speicherbelegung den angegebenen Speicherort enthält.

Syntax

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

Parameter

[in] Offset

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

[in] StartIndex

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

[in] Flags

Gibt einen Bitsatz mit Optionen an, die bei der Suche nach dem Modul mit dem angegebenen Speicherort verwendet werden. Flags können die folgenden Bitflags enthalten:

Flag	Auswirkung
DEBUG_GETMOD_NO_LOADED_MODULES	Suchen Sie die geladenen Module nicht.
DEBUG_GETMOD_NO_UNLOADED_MODULES	Suchen Sie die entladenen Module nicht.

[out, optional] Index

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

[out, optional] Base

Empfängt den Speicherort im Speicheradressraum des Ziels der Basis des Moduls. Wenn Basenull ist, werden diese Informationen nicht zurückgegeben.

Rückgabewert

Diese Methode gibt möglicherweise auch Fehlerwerte zurück. Weitere Informationen finden Sie unter Rückgabewerte .

Rückgabecode	BESCHREIBUNG
S_OK	Die Methode war erfolgreich.

Hinweise

Ab dem angegebenen Index gibt diese Methode das erste gefundene Modul zurück, dessen Adressbereich für die Speicherbelegung den angegebenen Speicherort enthält. Wenn das Ziel über mehrere Module verfügt, 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.