Partager via


ICorDebugVirtualUnwinder::GetContext, méthode

Obtient le contexte actuel de ce dérouleur.

Syntaxe

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

Paramètres

contextFlags [in] Indicateurs qui spécifient les parties du contexte à retourner (définies dans WinNT.h).

cbContextBuf [in] Nombre d’octets en contextBuf.

contextSize [out] Pointeur vers le nombre d’octets réellement écrits dans contextBuf.

contextBuf [out] Tableau d’octets qui contient le contexte actuel de ce déroulement.

Valeur renvoyée

Toute valeur HRESULT indiquant un échec reçue par mscordbi est considérée comme irrécupérable et forcent les API ICorDebug à retourner CORDBG_E_DATA_TARGET_ERROR.

Remarques

Vous affectez à la valeur initiale de l’argument contextBuf la mémoire tampon de contexte retournée par l’appel de la méthode ICorDebugStackWalk::GetContext.

Notes

Cette méthode est uniquement disponible avec .NET Native.

Le déroulement ne pouvant restaurer 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 de la méthode.

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.6, .NET Native uniquement

Voir aussi