Partager via


ICorDebugStackWalk ::GetContext, méthode

Retourne le contexte de l’image actuelle 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 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 suivantes ainsi que les erreurs HRESULT qui indiquent une défaillance de méthode.

HRESULT Descriptif
S_OK Le contexte de l’image actuelle a été retourné avec succès.
E_FAIL Impossible de renvoyer 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 d’image se trouve déjà à la fin de la pile ; par conséquent, aucune trame supplémentaire n’est accessible.

Exceptions

Remarques

Étant donné que le déroulement restaure uniquement un sous-ensemble des registres, tels que les registres non volatiles, le contexte peut ne pas correspondre exactement à l’état du registre au moment de l’appel.

Spécifications

Plates-formes: Consultez les systèmes d’exploitation pris en charge par .NET.

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

Bibliothèque: CorGuids.lib

Versions de .NET : Disponible depuis .NET Framework 4.0