IDebugSymbols3::GetSymbolEntryOffsetRegions-Methode (dbgeng.h)

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

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 sich auf das Verhalten dieser Methode auswirken.

[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 von Regionen, die für das Symbol verfügbar sind.

Rückgabewert

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

Diese Funktion gibt alle bekannten Speicherbereiche zurück, die einem angegebenen Symbol zugeordnet sind. Einfache Symbole verfügen über einen einzelnen Bereich, der von ihrer Basis aus beginnt. Kompliziertere 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	Windows
Kopfzeile	dbgeng.h (dbgeng.h einschließen)

Weitere Informationen

DEBUG_MODULE_AND_ID

IDebugSymbols3

IDebugSymbols3::GetSourceEntryOffsetRegions