Metodo ICLRDataTarget3::GetExceptionRecordICLRDataTarget3::GetExceptionRecord Method

Chiamato dai servizi di accesso ai dati di Common Language Runtime (CLR) per recuperare il record di eccezione associato al processo destinazione.Called by the common language runtime (CLR) data access services to retrieve the exception record associated with the target process. Ad esempio, per una destinazione del dump, sarebbe equivalente al record di eccezione passato tramite la ExceptionParam argomento per il MiniDumpWriteDump funzione nella libreria di Windows eseguire il Debug della Guida (DbgHelp).For example, for a dump target, this would be equivalent to the exception record passed in via the ExceptionParam argument to the MiniDumpWriteDump function in the Windows Debug Help Library (DbgHelp).

SintassiSyntax

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

ParametriParameters

bufferSize
[in] La dimensione del buffer di input, in byte.[in] The input buffer size, in bytes. Deve essere uguale a sizeof( MINIDUMP_EXCEPTION).This must be equal to sizeof(MINIDUMP_EXCEPTION).

bufferUsed
[out] Un puntatore a un tipo ULONG32 che riceve il numero di byte effettivamente scritti nel buffer.[out] A pointer to a ULONG32 type that receives the number of bytes actually written to the buffer.

buffer
[out] Un puntatore a un buffer di memoria che riceve una copia del record di eccezione.[out] A pointer to a memory buffer that receives a copy of the exception record. Il record di eccezione viene restituito come un MINIDUMP_EXCEPTION tipo.The exception record is returned as a MINIDUMP_EXCEPTION type.

Valore restituitoReturn Value

Il valore restituito è S_OK in caso di esito positivo o un codice di errore HRESULT in caso di esito negativo.The return value is S_OK on success, or a failure HRESULT code on failure. I codici HRESULT possono includere, ma non sono limitati a, quanto segue:The HRESULT codes can include but are not limited to the following:

Codice restituitoReturn code DescrizioneDescription
S_OK Il metodo è riuscito.Method succeeded. Il record di eccezione è stato copiato nel buffer di output.The exception record has been copied to the output buffer.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Nessun record di eccezione è associato alla destinazione.No exception record is associated with the target.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) La dimensione del buffer di input non è uguale a sizeof(MINIDUMP_EXCEPTION).The input buffer size is not equal to sizeof(MINIDUMP_EXCEPTION).

NoteRemarks

MINIDUMP_EXCEPTION è una struttura definita in dbghelp. h e Imagehlp. h in Windows SDK.MINIDUMP_EXCEPTION is a structure defined in dbghelp.h and imagehlp.h in the Windows SDK.

Questo metodo è implementato dal writer dell'applicazione di debug.This method is implemented by the writer of the debugging application.

RequisitiRequirements

Piattaforme: vedere requisiti di sistema.Platforms: See System Requirements.

Intestazione: Clrdata. idl, Clrdata. HHeader: ClrData.idl, ClrData.h

Libreria: CorGuids. libLibrary: CorGuids.lib

Versioni di .NET framework: 4.6, 4.5.2, aggiornamento di novembre 2013 alla versione 4.5.14.6, 4.5.2, November 2013 update to 4.5.1.NET Framework Versions: 4.6, 4.5.2, aggiornamento di novembre 2013 alla versione 4.5.14.6, 4.5.2, November 2013 update to 4.5.1

Vedere ancheSee Also

Interfaccia ICLRDataTarget3ICLRDataTarget3 Interface
Metodo GetExceptionContextRecordGetExceptionContextRecord Method
Metodo GetExceptionThreadIDGetExceptionThreadID Method