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) |