IDebugSymbols3::GetScope-Methode (dbgeng.h)

Artikel
02/26/2024

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 Stapelrahmen 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 zu enthalten.

[in] ScopeContextSize

Gibt die Größe des Puffers ScopeContext an.

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.
E_INVALIDARG	Die Größe des Puffers ScopeContext war nicht groß genug, um den Kontext des Bereichs zu enthalten.