Partager via

ICLRDataTarget3::GetExceptionContextRecord, méthode

  • Article

Appelée par les services d'accès aux données du CLR (Common Langage Runtime) pour récupérer l'enregistrement de contexte associé au processus cible. Par exemple, pour une cible d’image mémoire, ceci serait équivalent à l’enregistrement de contexte transmis via l’argument ExceptionParam à la fonction MiniDumpWriteDump de la bibliothèque d’aide au débogage Windows (DbgHelp).

Syntaxe

HRESULT GetExceptionContextRecord(  
    [in] ULONG32 bufferSize,  
    [out] ULONG32* bufferUsed,  
    [out, size_is(bufferSize)] BYTE* buffer  
);

Paramètres

bufferSize
[en entrée] La taille de la mémoire tampon d'entrée, en octets. Elle doit être d'une taille suffisante pour contenir l'enregistrement de contexte.

bufferUsed
[en sortie] Un pointeur vers un type ULONG32 qui reçoit le nombre d'octets réellement écrits dans la mémoire tampon.

buffer
[en sortie] Un pointeur vers une mémoire tampon qui reçoit une copie de l'enregistrement de contexte. L’enregistrement d’exception est retourné en tant que type CONTEXT.

Valeur de retour

La valeur de retour est S_OK en cas de réussite ou un code d'échec HRESULT en cas d'échec. Les codes HRESULT peuvent comprendre, sans y être limités, ce qui suit :

Code de retour Description
S_OK La méthode a réussi. L'enregistrement de contexte a été copié dans la mémoire tampon de sortie.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Aucun enregistrement de contexte n'est associé à la cible.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) La taille de la mémoire tampon d'entrée est insuffisante pour contenir l'enregistrement de contexte.

Notes

CONTEXT est une structure spécifique à une plateforme, définie dans les en-têtes fournis par le SDK Windows.

Cette méthode est implémentée par le writer de l'application de débogage.

Spécifications

Plateformes : Consultez Configuration requise.

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

Bibliothèque : CorGuids.lib

Versions de .NET Framework : Disponibles depuis la mise à jour de novembre 2013 vers la version 4.5.1

Voir aussi