Partager via

ICorDebugThread3 ::GetActiveInternalFrames, méthode

Retourne un tableau de trames 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 en 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 tableau de trames internes sur la pile.

Valeur de retour

Cette méthode retourne les HRESULT spécifiques suivantes ainsi que les erreurs HRESULT qui indiquent une défaillance de méthode.

HRESULT Descriptif
S_OK L’objet ICorDebugInternalFrame2 a été créé avec succès.
E_INVALIDARG cInternalFrames n’est pas 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 trames 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 cInternalFrames paramètre sur 0 (zéro) et le ppInternalFrames paramètre sur Null. Lorsque vous retournez GetActiveInternalFrames d’abord, pcInternalFrames contient le nombre d’images internes sur la pile.

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

Utilisez la méthode ICorDebugStackWalk ::GetFrame pour retourner les trames de pile réelles.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

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

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 4.0

  • Last updated on