Teilen über


ICorDebugStackWalk::GetContext-Methode

Gibt den Kontext für den aktuellen Frame im Objekt ICorDebugStackWalk zurück.

Syntax

HRESULT GetContext([in]  ULONG32 contextFlags,  
                   [in]  ULONG32 contextBufSize,  
                   [out] ULONG32* contextSize,  
                   [out, size_is(contextBufSize)] BYTE contextBuf[]);  

Parameter

contextFlags
[in] Flags, die den angeforderten Inhalt des Kontextpuffers (definiert in „WinNT.h“) angeben.

contextBufSize
[in] Die zugeordnete Größe des Kontextpuffers.

contextSize
[out] Die tatsächliche Größe des Kontexts. Dieser Wert muss kleiner sein als der Größenwert des Kontextpuffers oder diesem entsprechen.

contextBuf
[out] Der Kontextpuffer.

Rückgabewert

Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler zurück, die Methodenfehler anzeigen.

HRESULT BESCHREIBUNG
S_OK Der Kontext für den aktuellen Frame wurde erfolgreich zurückgegeben.
E_FAIL Der Kontext konnte nicht zurückgegeben werden.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER) Der Kontextpuffer ist zu klein.
CORDBG_E_PAST_END_OF_STACK Der Framezeiger befindet sich bereits am Ende des Stapels, sodass auf keine zusätzlichen Frames zugegriffen werden kann.

Ausnahmen

Bemerkungen

Da beim Entladen möglicherweise nur eine Teilmenge der Register (z. B. nur die permanenten Register) wiederhergestellt werden, stimmt der Kontext möglicherweise nicht genau mit dem Registerzustand zum Zeitpunkt des eigentlichen Methodenaufrufs überein.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.

Header: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET Framework-Versionen: Seit Version 4 verfügbar

Siehe auch