Metodo ICLRDataTarget3::GetExceptionRecord

  • Articolo

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 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] La dimensione del buffer di input, in byte. Questo deve essere uguale a sizeof(MINIDUMP_EXCEPTION).

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

buffer
[out] Un 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).

Commenti

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 di .NET Framework.

Intestazione: ClrData.idl, ClrData.h

Libreria: CorGuids.lib

Versioni di .NET Framework: Disponibile da novembre 2013 aggiornamento alla versione 4.5.1

Vedi anche