Freigeben über


IDebugSymbols3::SetScopeFrameByIndex-Methode (dbgeng.h)

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 Stapelrahmens 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, weist index null auf.

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.

Hinweise

Wenn ein Ereignis auftritt und die Debugger-Engine in ein Ziel einbricht, wird der Bereich auf den aktuellen Funktionsaufruf festgelegt (die Funktion, die ausgeführt wurde, als das Ereignis aufgetreten ist). Durch Aufrufen dieser Methode, bei der Index auf 1 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 Aufrufers usw. geändert.

Weitere Informationen zu Bereichen finden Sie unter Bereiche und Symbolgruppen.

Anforderungen

Anforderung Wert
Zielplattform Desktop
Kopfzeile dbgeng.h (einschließlich Dbgeng.h)

Weitere Informationen

.frame (Lokaler Kontext festlegen)

GetCurrentScopeFrameIndex

IDebugSymbols3

SetScope

SetScopeFromStoredEvent