Freigeben über


ICorDebugThread3::GetActiveInternalFrames-Methode

Gibt ein Array interner 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[]
      );

Die Parameter

cInternalFrames [in] Die Anzahl der internen Frames, die in ppInternalFrames.

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 auf Methodenfehler hinweisen.

HRESULT Description
S_OK Das ICorDebugInternalFrame2-Objekt wurde erfolgreich erstellt.
E_INVALIDARG cInternalFrames ist nicht null und ppInternalFrames ist null, oder pcInternalFrames ist null.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) ppInternalFrames ist kleiner als die Anzahl interner Frames.

Exceptions

Bemerkungen

Interne Frames sind Datenstrukturen, die von der Laufzeit an den Stapel übertragen werden, um temporäre Daten zu speichern.

Beim ersten Aufruf GetActiveInternalFramessollten Sie den cInternalFrames Parameter auf 0 (null) und den ppInternalFrames Parameter auf NULL festlegen. Wenn GetActiveInternalFrames der erste Wert zurückgegeben wird, pcInternalFrames enthält die Anzahl der internen Frames im Stapel.

GetActiveInternalFrames sollte dann ein zweites Mal aufgerufen werden. Sie sollten die richtige Anzahl (pcInternalFrames) im cInternalFrames Parameter übergeben und einen Zeiger auf ein entsprechend großes Array in ppInternalFrames.

Verwenden Sie die ICorDebugStackWalk::GetFrame-Methode , um tatsächliche Stapelframes zurückzugeben.

Anforderungen

Plattformen: Siehe .NET unterstützte Betriebssysteme.

Kopfball: CorDebug.idl, CorDebug.h

Bibliothek: CorGuids.lib

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