ICorDebugStackWalk::GetContext, méthode

Article
05/09/2023

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

Syntaxe

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

Paramètres

contextFlags
[in] Indicateurs qui spécifient le contenu demandé de la mémoire tampon de contexte (définie 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

Share via