ICorDebugStackWalk::SetContext, méthode

Article
05/10/2023

Définit le contexte actuel de l’objet ICorDebugStackWalk sur un contexte valide pour le thread.

Syntaxe

HRESULT SetContext([in] CorDebugSetContextFlag flag,  
                   [in] ULONG32 contextSize,  
                   [in, size_is(contextSize)] BYTE context[]);

Paramètres

flag
[in] Indicateur CorDebugSetContextFlag qui indique si le contexte provient du frame actif de la pile ou d’un contexte obtenu en déroulant la pile.

contextSize
[in] Taille allouée de la mémoire tampon CONTEXT.

context
[in] Mémoire tampon CONTEXT.

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 de l’objet `ICorDebugStackWalk` a été défini.
E_FAIL	Le contexte de l’objet `ICorDebugStackWalk` n’a pas été défini.
E_INVALIDARG	Le contexte a la valeur null.
HRESULT_FROM_WIN32(ERROR_INSUFFICIENT_BUFFER)	La mémoire tampon de contexte est trop petite.

Exceptions

Remarques

Cette méthode ne modifie pas le contexte actuel du thread.

L’affectation d’un contexte non valide au contexte actuel peut entraîner des résultats imprévisibles de l’analyseur de pile.

Vous pouvez récupérer une copie exacte au niveau du bit de ce contexte en appelant immédiatement la méthode ICorDebugStackWalk::GetContext .

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

Partager via