Freigeben über

ICorDebugStackWalk::GetContext-Methode

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

Syntax

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

Die Parameter

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

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

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

contextBuf [out] Der Kontextpuffer.

Rückgabewert

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

HRESULT Description
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 Rahmenzeiger befindet sich bereits am Ende des Stapels. Daher können auf keine zusätzlichen Frames zugegriffen werden.

Exceptions

Bemerkungen

Da das Entspannen nur eine Teilmenge der Register wie z. B. nicht veränderliche Register wiedergibt, stimmt der Kontext möglicherweise nicht exakt mit dem Registerstatus zum Zeitpunkt des Anrufs überein.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

.NET-Versionen: Verfügbar seit .NET Framework 4.0

  • Last updated on