IXCLRDataStackWalk::GetContext-Methode

Ruft den aktuellen Kontext dieses Stapelexemplars ab.

Note

Diese API wurde ursprünglich für die interne Verwendung in der Runtime entwickelt. Obwohl sie jetzt für die Verwendung durch Dritte unterstützt wird, wird empfohlen, nach Möglichkeit mit den APIs ICorDebug und ICorProfiler zu arbeiten.

Syntax

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

Parameter

contextFlags
[in] Die Flags, die steuern, welche Teile des Kontexts zurückgegeben werden sollen.

contextBufSize
[in] Die Größe des Puffers contextBuf .

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

contextBuf
[out, size_is(contextBufSize)] Ein Puffer, der den Kontext speichert.

Remarks

Die bereitgestellte Methode ist Teil der IXCLRDataStackWalk Schnittstelle und entspricht dem 4. Steckplatz der tabelle der virtuellen Methode.

Der Kontext ist der ursprüngliche Kontext, in dem alle auf sie angewendeten Abspannen angewendet werden. Da der Abbruch nur eine Teilmenge der Register wiederherstellen kann, wie z. B. nur nicht veränderliche Register, stimmt der Kontext möglicherweise nicht exakt mit dem Registerstatus zum Zeitpunkt des tatsächlichen Aufrufs überein.

Anforderungen

Plattformen: Informationen finden Sie unter Systemanforderungen.
Kopfball: Nichts
Bibliothek: Nichts
.NET Framework-Versionen: Seit 4.7 verfügbar

Siehe auch