Share via

ICLRDataTarget3::GetExceptionRecord, méthode

  • Article

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

Syntaxe

HRESULT GetExceptionRecord(  
    [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. Cela doit être égal à sizeof(MINIDUMP_EXCEPTION).

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 l'exception. L’enregistrement d’exception est retourné en tant que type MINIDUMP_EXCEPTION.

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 l'exception a été copié dans la mémoire tampon de sortie.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Aucun enregistrement d'exception n'est associé à la cible.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) La taille de la mémoire tampon d'entrée est différente de sizeof(MINIDUMP_EXCEPTION).

Notes

MINIDUMP_EXCEPTION est une structure définie dans dbghelp.h et imagehlp.h, dans le Kit de développement logiciel (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