Metodo ICLRDataTarget3::GetExceptionRecord

Articolo
11/05/2024

Chiamato dai servizi di accesso ai dati di Common Language Runtime (CLR) per recuperare il record di eccezione associato al processo destinazione. Ad esempio, per una destinazione di dump, questo equivale al record di eccezione passato tramite l'argomento ExceptionParam alla funzione MiniDumpWriteDump nella libreria della Guida di debug di Windows (DbgHelp).

Sintassi

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

Parametri

bufferSize [in] Dimensioni del buffer di input, in byte. Deve essere uguale a sizeof(MINIDUMP_EXCEPTION).

bufferUsed [out] Puntatore a un ULONG32 tipo che riceve il numero di byte effettivamente scritti nel buffer.

buffer [out] Puntatore a un buffer di memoria che riceve una copia del record di eccezione. Il record di eccezione viene restituito come tipo di MINIDUMP_EXCEPTION .

Valore restituito

Il valore restituito è S_OK in caso di esito positivo o un codice di errore HRESULT in caso di esito negativo. I codici HRESULT possono includere, ma non sono limitati a, quanto segue:

Codice restituito	Descrizione
`S_OK`	Il metodo è riuscito. Il record di eccezione è stato copiato nel buffer di output.
`HRESULT_FROM_WIN32(ERROR_NOT_FOUND)`	Nessun record di eccezione è associato alla destinazione.
`HRESULT_FROM_WIN32(ERROR_BAD_LENGTH)`	La dimensione del buffer di input non è uguale a `sizeof(MINIDUMP_EXCEPTION)`.

Osservazioni:

MINIDUMP_EXCEPTION è una struttura definita in dbghelp.h e imagehlp.h in Windows SDK.

Questo metodo è implementato dal writer dell'applicazione di debug.

Requisiti

Piattaforme: vedere Requisiti di sistema.

Intestazione: ClrData.idl, ClrData.h

Libreria: CorGuids.lib

Versioni di .NET Framework: disponibili dall'aggiornamento di novembre 2013 alla versione 4.5.1

Condividi tramite