Methode ICorDebugThread3::GetActiveInternalFrames

Artikel
05/10/2023

Retourneert een matrix van interne frames (ICorDebugInternalFrame2-objecten ) op de stack.

Syntaxis

HRESULT GetActiveInternalFrames  
      (  
      [in] ULONG32 cInternalFrames,  
      [out] ULONG32 *pcInternalFrames,  
      [in, out,size_is(cInternalFrames), length_is(*pcInternalFrames)]  
            ICorDebugInternalFrame2 * ppInternalFrames[]  
      );

Parameters

cInternalFrames
[in] Het aantal interne frames dat wordt verwacht in ppInternalFrames.

pcInternalFrames
[uit] Een aanwijzer naar een ULONG32 die het aantal interne frames op de stapel bevat.

ppInternalFrames
[in, uit] Een verwijzing naar het adres van een matrix met interne frames op de stapel.

Retourwaarde

Deze methode retourneert de volgende specifieke HRESULT's en HRESULT-fouten die wijzen op een fout in de methode.

HRESULT	Beschrijving
S_OK	Het object ICorDebugInternalFrame2 is gemaakt.
E_INVALIDARG	`cInternalFrames` is niet nul en `ppInternalFrames` is `null`, of `pcInternalFrames` is `null`.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	`ppInternalFrames` is kleiner dan het aantal interne frames.

Uitzonderingen

Opmerkingen

Interne frames zijn gegevensstructuren die door de runtime naar de stack worden gepusht om tijdelijke gegevens op te slaan.

Wanneer u voor het eerst aanroept GetActiveInternalFrames, moet u de cInternalFrames parameter instellen op 0 (nul) en de ppInternalFrames parameter op null. Wanneer GetActiveInternalFrames voor het eerst wordt geretourneerd, pcInternalFrames bevat het aantal interne frames op de stack.

GetActiveInternalFrames moet dan een tweede keer worden aangeroepen. Geef het juiste aantal (pcInternalFrames) door in de cInternalFrames parameter en geef een aanwijzer op naar een matrix met de juiste grootte in ppInternalFrames.

Gebruik de methode ICorDebugStackWalk::GetFrame om werkelijke stackframes te retourneren.

Vereisten

Platforms: Zie Systeemvereisten.

Header: CorDebug.idl, CorDebug.h

Bibliotheek: CorGuids.lib

.NET Framework versies: beschikbaar sinds 4

Delen via