ICorDebugThread3::GetActiveInternalFrames, méthode
Retourne un tableau des frames internes (objets ICorDebugInternalFrame2) sur la pile.
HRESULT GetActiveInternalFrames
(
[in] ULONG32 cInternalFrames,
[out] ULONG32 *pcInternalFrames,
[in, out,size_is(cInternalFrames), length_is(*pcInternalFrames)]
ICorDebugInternalFrame2 * ppInternalFrames[]
);
Paramètres
cInternalFrames
[in] Nombre de frames internes prévus dans ppInternalFrames.pcInternalFrames
[out] Pointeur vers un ULONG32 qui contient le nombre de frames internes sur la pile.ppInternalFrames
[in, out] Pointeur vers l'adresse d'un tableau de frames internes sur la pile.
Valeur de retour
Cette méthode retourne les HRESULT spécifiques suivants ainsi que les erreurs HRESULT qui indiquent l'échec de la méthode.
HRESULT |
Description |
|---|---|
S_OK |
L'objet ICorDebugInternalFrame2 a été correctement 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 de frames internes. |
Notes
Les frames internes sont des structures de données qui font l'objet d'un push vers la pile par le runtime pour stocker des données temporaires.
Lorsque vous appelez GetActiveInternalFrames pour la première fois, vous devez affecter au paramètre cInternalFrames la valeur 0 (zéro) et au paramètre ppInternalFrames la valeur null. Lors du premier retour de GetActiveInternalFrames, pcInternalFrames contient le nombre de frames internes sur la pile.
GetActiveInternalFrames doit ensuite être appelé une deuxième fois. Vous devez passer le nombre correct (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éels.
Configuration requise
Plateformes : consultez Configuration requise du .NET Framework.
En-tête : CorDebug.idl, CorDebug,h
Bibliothèque : CorGuids.lib
Versions du .NET Framework : 4