ICLRDataTarget3::GetExceptionContextRecord, méthode
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 [in] 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 [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 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
