ICorDebugThread3::GetActiveInternalFrames — Metoda
Zwraca tablicę ramek wewnętrznych (obiektów ICorDebugInternalFrame2 ) na stosie.
Składnia
HRESULT GetActiveInternalFrames
(
[in] ULONG32 cInternalFrames,
[out] ULONG32 *pcInternalFrames,
[in, out,size_is(cInternalFrames), length_is(*pcInternalFrames)]
ICorDebugInternalFrame2 * ppInternalFrames[]
);
Parametry
cInternalFrames [in] Liczba ramek wewnętrznych oczekiwana w pliku ppInternalFrames.
pcInternalFrames [out] Wskaźnik do, ULONG32 który zawiera liczbę ramek wewnętrznych na stosie.
ppInternalFrames [in, out] Wskaźnik do adresu tablicy ramek wewnętrznych na stosie.
Wartość zwracana
Ta metoda zwraca następujące określone elementy HRESULTs, a także błędy HRESULT wskazujące niepowodzenie metody.
| HRESULT | opis |
|---|---|
| S_OK | Obiekt ICorDebugInternalFrame2 został pomyślnie utworzony. |
| E_INVALIDARG | cInternalFrames nie ma wartości zero i ppInternalFrames ma nullwartość , lub pcInternalFrames ma wartość null. |
| HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) | ppInternalFrames jest mniejsza niż liczba ramek wewnętrznych. |
Wyjątki
Uwagi
Wewnętrzne ramki to struktury danych wypychane do stosu przez środowisko uruchomieniowe w celu przechowywania danych tymczasowych.
Podczas pierwszego wywołania GetActiveInternalFramesparametru należy ustawić cInternalFrames parametr na 0 (zero), a parametr ma ppInternalFrames wartość null. Po GetActiveInternalFrames pierwszym powrocie pcInternalFrames zawiera liczbę ramek wewnętrznych na stosie.
GetActiveInternalFrames następnie powinien być wywoływany po raz drugi. Należy przekazać odpowiednią liczbę (pcInternalFrames) w parametrze cInternalFrames i określić wskaźnik do tablicy o odpowiednim rozmiarze w pliku ppInternalFrames.
Użyj metody ICorDebugStackWalk::GetFrame, aby zwrócić rzeczywiste ramki stosu.
Wymagania
Platformy: zobacz Wymagania systemowe.
Nagłówek: CorDebug.idl, CorDebug.h
Biblioteka: CorGuids.lib
Wersje programu .NET Framework: dostępne od 4
