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