IDebugSymbols2::SetScope-Methode (dbgeng.h)

Artikel
02/06/2025

Die SetScope--Methode legt den aktuellen Bereich fest.

Syntax

HRESULT SetScope(
  [in]           ULONG64            InstructionOffset,
  [in, optional] PDEBUG_STACK_FRAME ScopeFrame,
  [in, optional] PVOID              ScopeContext,
  [in]           ULONG              ScopeContextSize
);

Parameter

[in] InstructionOffset

Gibt den Speicherort im virtuellen Adressbereich des Prozesses für die aktuelle Anweisung des Bereichs an. Dies wird nur verwendet, wenn sowohl ScopeFrame- als auch ScopeContext-NULL-sind; andernfalls wird sie ignoriert.

[in, optional] ScopeFrame

Gibt den Stapelframe des Bereichs an. Informationen zu dieser Struktur finden Sie unter DEBUG_STACK_FRAME.

[in, optional] ScopeContext

Gibt den Threadkontext des Bereichsan. 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. Wenn ScopeContext-NULL-ist, wird stattdessen der aktuelle Registerkontext verwendet.

[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	Der durch InstructionOffset-, ScopeFrame-und ScopeContext- identifizierte Bereich entspricht dem alten Bereich.
S_FALSE	Der Bereich wurde geändert.

Bemerkungen

Wenn nur InstructionOffset- angegeben wird, kann der Bereich zum Nachschlagen von Symbolnamen verwendet werden. Die Werte dieser Symbole sind jedoch nicht verfügbar.

Um den Bereich auf einen vorherigen Zustand festzulegen, muss ScopeContext- bereitgestellt werden. Dies ist nicht immer erforderlich (z. B. wenn Sie nur auf die Symbole und nicht auf die registriert). Um den Bereich auf einen Frame im aktuellen Stapel festzulegen, können SetScopeFrameByIndex- verwendet werden.

Weitere Informationen zu Bereichen finden Sie unter Bereiche und Symbolgruppen.