ICorDebugThread3::GetActiveInternalFrames-Methode
Gibt ein Array aus internen Frames (ICorDebugInternalFrame2-Objekte) im Stapel zurück.
Syntax
HRESULT GetActiveInternalFrames
(
[in] ULONG32 cInternalFrames,
[out] ULONG32 *pcInternalFrames,
[in, out,size_is(cInternalFrames), length_is(*pcInternalFrames)]
ICorDebugInternalFrame2 * ppInternalFrames[]
);
Parameter
cInternalFrames
[in] Die Anzahl der internen Frames, die in ppInternalFrames erwartet werden.
pcInternalFrames
[out] Ein Zeiger auf ein ULONG32-Element, das die Anzahl der internen Frames im Stapel enthält.
ppInternalFrames
[in, out] Ein Zeiger auf die Adresse eines Arrays interner Frames im Stapel.
Rückgabewert
Diese Methode gibt die folgenden spezifischen HRESULTs sowie HRESULT-Fehler zurück, die Methodenfehler anzeigen.
| HRESULT | BESCHREIBUNG |
|---|---|
| S_OK | Das ICorDebugInternalFrame2-Objekt wurde erfolgreich erstellt. |
| E_INVALIDARG | cInternalFrames ist nicht 0, und ppInternalFrames ist null, oder pcInternalFrames ist null. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | ppInternalFrames ist kleiner als die Anzahl interner Frames. |
Ausnahmen
Bemerkungen
Interne Frames sind Datenstrukturen, die von der Runtime in den Stapel übertragen werden, um temporäre Daten zu speichern.
Wenn Sie GetActiveInternalFrames zum ersten Mal aufrufen, sollten Sie den Parameter cInternalFrames auf 0 (null) und den Parameter ppInternalFrames auf NULL festlegen. Wenn GetActiveInternalFrames zum ersten Mal zurückgegeben wird, enthält pcInternalFrames die Anzahl der internen Frames im Stapel.
GetActiveInternalFrames sollte dann ein zweites Mal aufgerufen werden. Sie sollten die richtige Anzahl (pcInternalFrames) im Parameter cInternalFrames übergeben und einen Zeiger auf ein entsprechend dimensioniertes Array in ppInternalFrames angeben.
Verwenden Sie die ICorDebugStackWalk::GetFrame-Methode, um tatsächliche Stapelframes zurückzugeben.
Anforderungen
Plattformen: Informationen finden Sie unter Systemanforderungen.
Header: CorDebug.idl, CorDebug.h
Bibliothek: CorGuids.lib
.NET Framework-Versionen: seit Version 4 verfügbar
