Dela via


ICLRDataTarget3::GetExceptionRecord-metod

Anropas av CLR-dataåtkomsttjänsterna (Common Language Runtime) för att hämta undantagsposten som är associerad med målprocessen. För ett dumpmål skulle det till exempel motsvara undantagsposten som skickas via ExceptionParam argumentet till funktionen MiniDumpWriteDump i hjälpbiblioteket för Windows Debug (DbgHelp).

Syntax

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

Parametrar

bufferSize [i] Indatabuffertens storlek i byte. Detta måste vara lika med sizeof(MINIDUMP_EXCEPTION).

bufferUsed [ut] En pekare till en ULONG32 typ som tar emot antalet byte som faktiskt skrivits till bufferten.

buffer [ut] En pekare till en minnesbuffert som tar emot en kopia av undantagsposten. Undantagsposten returneras som en MINIDUMP_EXCEPTION typ.

Returvärde

Returvärdet är S_OK vid lyckat resultat eller en felkod HRESULT vid fel. Koderna HRESULT kan innehålla men är inte begränsade till följande:

Returnera kod beskrivning
S_OK Metoden lyckades. Undantagsposten har kopierats till utdatabufferten.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Ingen undantagspost är associerad med målet.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) Indatabuffertens storlek är inte lika med sizeof(MINIDUMP_EXCEPTION).

Kommentarer

MINIDUMP_EXCEPTION är en struktur som definieras i dbghelp.h och imagehlp.h i Windows SDK.

Den här metoden implementeras av författaren till felsökningsprogrammet.

Krav

Plattformar: Se Systemkrav.

Rubrik: ClrData.idl, ClrData.h

Bibliotek: CorGuids.lib

.NET Framework-versioner: Tillgänglig sedan november 2013 uppdatering till 4.5.1

Se även