Delen via

Methode ICLRDataTarget3::GetExceptionRecord

Aangeroepen door de common language runtime (CLR) data access services om de uitzonderingsrecord op te halen die is gekoppeld aan het doelproces. Voor een dumpdoel zou dit bijvoorbeeld gelijk zijn aan de uitzonderingsrecord die via het ExceptionParam argument is doorgegeven aan de functie MiniDumpWriteDump in de Help-bibliotheek voor Foutopsporing van Windows (DbgHelp).

Syntaxis

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

Parameters

bufferSize [in] De grootte van de invoerbuffer, in bytes. Dit moet gelijk zijn aan sizeof(MINIDUMP_EXCEPTION).

bufferUsed [uit] Een aanwijzer naar een ULONG32 type dat het aantal bytes ontvangt dat daadwerkelijk naar de buffer is geschreven.

buffer [uit] Een aanwijzer naar een geheugenbuffer die een kopie van de uitzonderingsrecord ontvangt. De uitzonderingsrecord wordt geretourneerd als een MINIDUMP_EXCEPTION type.

Retourwaarde

De retourwaarde is S_OK geslaagd of een foutcode HRESULT bij een fout. De HRESULT codes kunnen omvatten, maar zijn niet beperkt tot het volgende:

Retourcode Beschrijving
S_OK De methode is voltooid. De uitzonderingsrecord is gekopieerd naar de uitvoerbuffer.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Er is geen uitzonderingsrecord gekoppeld aan het doel.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) De grootte van de invoerbuffer is niet gelijk aan sizeof(MINIDUMP_EXCEPTION).

Opmerkingen

MINIDUMP_EXCEPTION is een structuur die is gedefinieerd in dbghelp.h en imagehlp.h in de Windows SDK.

Deze methode wordt geïmplementeerd door de schrijver van de foutopsporingstoepassing.

Vereisten

Platformen: Zie Systeemvereisten.

Header: ClrData.idl, ClrData.h

Bibliotheek: CorGuids.lib

.NET Framework-versies: beschikbaar sinds de update van november 2013 naar 4.5.1

Zie ook

  • Last updated on