IDebugSymbols3::GetSymbolEntryOffsetRegions-Methode (dbgeng.h)

Artikel
02/06/2025

Gibt alle Speicherbereiche zurück, die einem Symbol zugeordnet werden sollen.

Syntax

HRESULT GetSymbolEntryOffsetRegions(
  [in]            PDEBUG_MODULE_AND_ID Id,
  [in]            ULONG                Flags,
  [out]           PDEBUG_OFFSET_REGION Regions,
  [in]            ULONG                RegionsCount,
  [out, optional] PULONG               RegionsAvail
);

Parameter

[in] Id

Die ID eines Moduls als Zeiger auf eine DEBUG_MODULE_AND_ID Struktur.

[in] Flags

Ein Bitsatz, der Optionen enthält, die das Verhalten dieser Methode beeinflussen.

[out] Regions

Die Speicherbereiche, die dem Symbol zugeordnet sind.

[in] RegionsCount

Die Anzahl der Regionen, die dem Symbol zugeordnet sind.

[out, optional] RegionsAvail

Ein Zeiger auf die Anzahl der Regionen, die für das Symbol verfügbar sind.

Rückgabewert

Wenn diese Methode erfolgreich ist, wird S_OKzurückgegeben. Andernfalls wird ein HRESULT- Fehlercode zurückgegeben.

Diese Funktion gibt alle bekannten Speicherbereiche zurück, die einem angegebenen Symbol zugeordnet sind. Einfache Symbole weisen einen einzelnen Bereich auf, der von ihrer Basis aus beginnt. Komplexere Regionen, z. B. Funktionen mit mehreren Codebereichen, können beliebig viele Regionen aufweisen.

Die Qualität der zurückgegebenen Informationen hängt stark von den verfügbaren symbolischen Informationen ab.

Anforderungen

Anforderung	Wert
Zielplattform-	Fenster
Header-	dbgeng.h (include Dbgeng.h)

Siehe auch

DEBUG_MODULE_AND_ID

IDebugSymbols3

IDebugSymbols3::GetSourceEntryOffsetRegions

Freigeben über