Dela via


ICLRDataTarget3::GetExceptionContextRecord-metod

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

Syntax

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

Parametrar

bufferSize [i] Indatabuffertens storlek i byte. Detta måste vara tillräckligt stort för att rymma kontextposten.

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 kontextposten. Undantagsposten returneras som en KONTEXT-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. Kontextposten har kopierats till utdatabufferten.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Ingen kontextpost är associerad med målet.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) Indatabuffertens storlek är inte tillräckligt stor för att rymma kontextposten.

Kommentarer

CONTEXT är en plattformsspecifik struktur som definieras i rubriker som tillhandahålls av 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