Lire en anglais

Partager via

ICorDebugStackWalk::GetContext, méthode

  • Article

Retourne le contexte du frame actuel dans l’objet ICorDebugStackWalk.

Syntaxe

C++ 
HRESULT GetContext([in]  ULONG32 contextFlags,
                   [in]  ULONG32 contextBufSize,
                   [out] ULONG32* contextSize,
                   [out, size_is(contextBufSize)] BYTE contextBuf[]);

Paramètres

contextFlags [in] Indicateurs qui indiquent le contenu demandé de la mémoire tampon de contexte (défini dans WinNT.h).

contextBufSize [in] Taille allouée de la mémoire tampon de contexte.

contextSize [out] Taille réelle du contexte. Cette valeur doit être inférieure ou égale à la taille de la mémoire tampon de contexte.

contextBuf [out] Mémoire tampon de contexte.

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 contexte du frame actuel a été retourné.
E_FAIL Impossible de retourner le contexte.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT BUFFER) La mémoire tampon de contexte est trop petite.
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

Le déroulement ne restaurant qu’un sous-ensemble des registres, par exemple les registres non volatiles, le contexte peut différer de l’état du registre au moment de l’appel.

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

Voir aussi