Partager via

ICorDebugStackWalk::GetFrame, méthode

  • Article

Obtient le frame actuel dans l’objet ICorDebugStackWalk.

Syntaxe

HRESULT GetFrame([out] ICorDebugFrame ** pFrame);

Paramètres

pFrame
[in] Pointeur vers l’adresse de l’objet de frame créé, qui représente le frame actuel dans 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 Le runtime a correctement retourné le frame actuel.
E_FAIL Le frame actuel n’a pas été retourné.
S_FALSE Le frame actuel est un frame de pile natif.
E_INVALIDARG pFrame a la valeur null.
CORDBG_E_PAST_END_OF_STACK Le pointeur de frame est déjà à la fin de la pile ; par conséquent, aucun frame supplémentaire n’est accessible.

Exceptions

Remarques

ICorDebugStackWalk retourne uniquement les frames de pile réels. Utilisez la méthode ICorDebugThread3::GetActiveInternalFrames pour retourner les frames internes. (Les frames internes sont des structures de données poussées vers la pile par le runtime pour stocker des données temporaires.)

Configuration requise

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponible depuis la version 4

Voir aussi