IDebugSymbols2::GetModuleByOffset-Methode (dbgeng.h)

Artikel
02/23/2024

Die GetModuleByOffset-Methode durchsucht die Module des Ziels nach einem Objekt, dessen Speicherbelegung 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 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.

[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.