ICorDebugThread3::GetActiveInternalFrames – metoda

Článek
11/05/2024

Vrátí pole interních rámců (objekty ICorDebugInternalFrame2 ) v zásobníku.

Syntaxe

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

Parametry

cInternalFrames [v] Počet interních snímků očekávaných v ppInternalFrames.

pcInternalFrames [ven] Ukazatel na ULONG32 hodnotu, která obsahuje počet interních snímků v zásobníku.

ppInternalFrames [in, out] Ukazatel na adresu pole interních rámců v zásobníku.

Návratová hodnota

Tato metoda vrátí následující konkrétní HRESULTs a také chyby HRESULT, které označují selhání metody.

HRESULT	Popis
S_OK	Objekt ICorDebugInternalFrame2 byl úspěšně vytvořen.
E_INVALIDARG	`cInternalFrames` není nula a `ppInternalFrames` je `null`, nebo `pcInternalFrames` je `null`.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	`ppInternalFrames` je menší než počet interních snímků.

Výjimky

Poznámky

Interní rámce jsou datové struktury vložené do zásobníku modulem runtime pro ukládání dočasných dat.

Při prvním volání GetActiveInternalFramesbyste měli nastavit cInternalFrames parametr na 0 (nula) a ppInternalFrames parametr na hodnotu null. Při GetActiveInternalFrames prvním vrácení pcInternalFrames obsahuje počet interních rámců v zásobníku.

GetActiveInternalFrames měla by být volána podruhé. V parametru cInternalFrames byste měli předat správný počet (pcInternalFrames) a zadat ukazatel na pole s odpovídající velikostí v ppInternalFrames.

K vrácení skutečných snímků zásobníku použijte metodu ICorDebugStackWalk::GetFrame .

Požadavky

Platformy: Viz požadavky na systém.

Hlavička: CorDebug.idl, CorDebug.h

Knihovna: CorGuids.lib

Verze rozhraní .NET Framework: Dostupné od verze 4

Sdílet prostřednictvím