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