Metodo ICorDebugThread3::GetActiveInternalFramesICorDebugThread3::GetActiveInternalFrames Method

Restituisce una matrice di frame interni (ICorDebugInternalFrame2 oggetti) nello stack.Returns an array of internal frames (ICorDebugInternalFrame2 objects) on the stack.

SintassiSyntax

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

ParametriParameters

cInternalFrames
[in] Il numero di frame interni previsti in ppInternalFrames.[in] The number of internal frames expected in ppInternalFrames.

pcInternalFrames
[out] Un puntatore a un ULONG32 che contiene il numero di frame interni nello stack.[out] A pointer to a ULONG32 that contains the number of internal frames on the stack.

ppInternalFrames
[in, out] Un puntatore all'indirizzo di una matrice di frame interni nello stack.[in, out] A pointer to the address of an array of internal frames on the stack.

Valore restituitoReturn Value

Questo metodo restituisce gli specifici HRESULT seguenti, nonché gli errori di HRESULT che indicano la mancata riuscita del metodo.This method returns the following specific HRESULTs as well as HRESULT errors that indicate method failure.

HRESULTHRESULT DescrizioneDescription
S_OKS_OK Il ICorDebugInternalFrame2 oggetto è stato creato correttamente.The ICorDebugInternalFrame2 object was successfully created.
E_INVALIDARGE_INVALIDARG cInternalFrames non è zero e ppInternalFrames viene null, o pcInternalFrames è null.cInternalFrames is not zero and ppInternalFrames is null, or pcInternalFrames is null.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER) ppInternalFrames è minore del numero di frame interni.ppInternalFrames is smaller than the count of internal frames.

EccezioniExceptions

NoteRemarks

Frame interni sono strutture di dati nello stack dal runtime per archiviare dati temporanei.Internal frames are data structures pushed onto the stack by the runtime to store temporary data.

Quando si chiama innanzitutto GetActiveInternalFrames, è necessario impostare il cInternalFrames parametro su 0 (zero) e ppInternalFrames parametro su null.When you first call GetActiveInternalFrames, you should set the cInternalFrames parameter to 0 (zero), and the ppInternalFrames parameter to null. Quando GetActiveInternalFrames restituita innanzitutto, pcInternalFrames contiene il numero di frame interni nello stack.When GetActiveInternalFrames first returns, pcInternalFrames contains the count of the internal frames on the stack.

GetActiveInternalFrames deve quindi essere chiamato una seconda volta.GetActiveInternalFrames should then be called a second time. È necessario passare il numero appropriato (pcInternalFrames) nei cInternalFrames parametro e specificare un puntatore a una matrice di dimensione appropriate in ppInternalFrames.You should pass the proper count (pcInternalFrames) in the cInternalFrames parameter, and specify a pointer to an appropriately sized array in ppInternalFrames.

Utilizzare il GetFrame frame dello stack per restituire effettivo.Use the ICorDebugStackWalk::GetFrame method to return actual stack frames.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Cordebug. idl, Cordebug. HHeader: CorDebug.idl, CorDebug.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: Disponibile dalla 4Available since 4.NET Framework Versions: Disponibile dalla 4Available since 4

Vedere ancheSee Also

Interfacce di debugDebugging Interfaces
DebugDebugging