IDebugSymbols3::SetScopeFrameByIndex-Methode (dbgeng.h)

Artikel
02/06/2025

Die SetScopeFrameByIndex--Methode legt den aktuellen Bereich auf den Bereich eines der Frames im Aufrufstapel fest.

Syntax

HRESULT SetScopeFrameByIndex(
  [in] ULONG Index
);

Parameter

[in] Index

Gibt den Index des Stapelframes an, aus dem der Bereich festgelegt werden soll. Der Index zählt die Anzahl der Frames vom oberen Rand des Aufrufstapels. Der Frame am oberen Rand des Stapels, der den aktuellen Aufruf darstellt, hat index 0.

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.

Bemerkungen

Wenn ein Ereignis auftritt und das Debuggermodul in ein Ziel einbricht, wird der Bereich auf den aktuellen Funktionsaufruf festgelegt (die Funktion, die beim Auftreten des Ereignisses ausgeführt wurde). Wenn Sie diese Methode mit Index aufrufen, auf eine festgelegt ist, wird der aktuelle Bereich in den Aufrufer der aktuellen Funktion geändert; wenn Index auf zwei festgelegt ist, wird der Bereich in den Aufrufer des Anrufers geändert usw.

Weitere Informationen zu Bereichen finden Sie unter Bereiche und Symbolgruppen.