ICorDebugThread3::GetActiveInternalFrames, méthode
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 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 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
