IDebugSymbols2::GetScope-Methode (dbgeng.h)

Artikel
02/06/2025

Die GetScope--Methode gibt Informationen zum aktuellen Bereich zurück.

Syntax

HRESULT GetScope(
  [out, optional] PULONG64           InstructionOffset,
  [out, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [out, optional] PVOID              ScopeContext,
  [in]            ULONG              ScopeContextSize
);

Parameter

[out, optional] InstructionOffset

Empfängt den Speicherort im virtuellen Adressraum des Prozesses der aktuellen Anweisung des aktuellen Bereichs.

[out, optional] ScopeFrame

Empfängt die DEBUG_STACK_FRAME Struktur, die den Stapelframe des aktuellen Bereichs darstellt.

[out, optional] ScopeContext

Empfängt den Threadkontext des aktuellen Bereichs. Der Typ des Threadkontexts ist die CONTEXT-Struktur für den effektiven Prozessor des Ziels. Der Puffer ScopeContext- muss groß genug sein, um diese Struktur aufzunehmen.

[in] ScopeContextSize

Gibt die Größe des Puffers ScopeContext-an.

Rückgabewert

Diese Methode kann auch Fehlerwerte zurückgeben. Weitere Informationen finden Sie unter Rückgabewerte.

Rückgabecode	Beschreibung
S_OK	Die Methode war erfolgreich.
E_INVALIDARG	Die Größe des Puffers ScopeContext- war nicht groß genug, um den Kontext des Bereichs zu halten.