ICLRDataTarget3::GetExceptionRecord, méthode
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 [in] Taille de la mémoire tampon d’entrée, en octets. Cela doit être égal à sizeof(MINIDUMP_EXCEPTION).
bufferUsed [out] Pointeur vers un ULONG32 type qui reçoit le nombre d’octets réellement écrits dans la mémoire tampon.
buffer [out] Pointeur vers une mémoire tampon qui reçoit une copie de l’enregistrement d’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
