ICorDebugVirtualUnwinder::GetContext-Methode

Artikel
11/05/2024

Ruft den aktuellen Kontext dieses Entladers ab.

Syntax

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

Parameter

contextFlags [in] Flags, die angeben, welche Teile des kontexts zurückgegeben werden sollen (definiert in WinNT.h).

cbContextBuf [in] Die Anzahl der Bytes in contextBuf.

contextSize [out] Ein Zeiger auf die Anzahl der Bytes, die tatsächlich in contextBuf.

contextBuf [out] Ein Bytearray, das den aktuellen Kontext dieses Abspanners enthält.

Rückgabewert

Alle von "mscordbi" empfangenen HRESULT-Fehlerwerte gelten als schwerwiegend und bewirken, dass "ICorDebug"-APIs CORDBG_E_DATA_TARGET_ERROR zurückgeben.

Bemerkungen

Sie legen den anfänglichen Wert des contextBuf-Arguments auf den Kontextpuffer fest, der durch Aufrufen der Methode ICorDebugStackWalk::GetContext zurückgegeben wird.

Hinweis

Diese Methode ist nur mit .NET Native verfügbar.

Da beim Entladen möglicherweise nur eine Teilmenge der Register (z. B. nur die nicht permanenten Register) wiederhergestellt werden, stimmt der Kontext möglicherweise nicht genau mit dem Registrierungszustand 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.6 verfügbar, nur .NET Native

Freigeben über