ICorDebugThread3::GetActiveInternalFrames, méthode

Article
05/10/2023

Retourne un tableau de cadres internes (objets ICorDebugInternalFrame2) sur la pile.

Syntaxe

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

Paramètres

cInternalFrames
[in] Nombre d’images internes attendues dans ppInternalFrames.

pcInternalFrames
[out] Pointeur vers un ULONG32 qui contient le nombre d’images internes sur la pile.

ppInternalFrames
[in, out] Pointeur vers l’adresse d’un groupe d’images internes sur la pile.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT indiquant l'échec de la méthode.

HRESULT	Description
S_OK	L’objet ICorDebugInternalFrame2 a bien été créé.
E_INVALIDARG	`cInternalFrames` est différent de zéro et `ppInternalFrames` est `null`, ou `pcInternalFrames` est `null`.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	`ppInternalFrames` est inférieur au nombre d’images internes.

Exceptions

Remarques

Les images internes sont des structures de données envoyées sur la pile par le runtime pour stocker des données temporaires.

Lorsque vous appelez GetActiveInternalFramespour la première fois, vous devez définir le paramètre cInternalFrames sur 0 (zéro) et le paramètre ppInternalFrames sur Null. Lorsque GetActiveInternalFrames retourne ses premiers résultats, pcInternalFrames contient le nombre d’images internes sur la pile.

GetActiveInternalFrames doit ensuite être appelé une seconde fois. Vous devez passer le nombre approprié (pcInternalFrames) dans le paramètre cInternalFrames et spécifier un pointeur vers un tableau de taille appropriée dans ppInternalFrames.

Utilisez la méthode ICorDebugStackWalk::GetFrame pour retourner des frames de pile réelles.

Spécifications

Plateformes : Consultez Configuration requise.

En-tête : CorDebug.idl, CorDebug.h

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Share via