ICLRDataTarget3::GetExceptionRecord – metoda
Je volána službami modulu Common Language Runtime (CLR) pro přístup k datům za účelem získání záznamu o výjimce související s cílovým procesem. Například pro cíl výpisu paměti by to bylo ekvivalentem záznamu výjimky předávaného prostřednictvím ExceptionParam argumentu funkce MiniDumpWriteDump v knihovně nápovědy ladění systému Windows (DbgHelp).
Syntaxe
HRESULT GetExceptionRecord(
[in] ULONG32 bufferSize,
[out] ULONG32* bufferUsed,
[out, size_is(bufferSize] BYTE* buffer
);
Parametry
bufferSize [v] Velikost vstupní vyrovnávací paměti v bajtech. Musí se rovnat sizeof(MINIDUMP_EXCEPTION).
bufferUsed [ven] Ukazatel na ULONG32 typ, který přijímá počet bajtů, které jsou skutečně zapsány do vyrovnávací paměti.
buffer [ven] Ukazatel na vyrovnávací paměť, která přijímá kopii záznamu výjimky. Záznam výjimky se vrátí jako typ MINIDUMP_EXCEPTION .
Návratová hodnota
Vrácená hodnota se provádí S_OK při úspěchu nebo kód selhání HRESULT při selhání. Kódy HRESULT můžou obsahovat následující kódy, ale nejsou omezeny na následující:
| Návratový kód | Popis |
|---|---|
S_OK |
Metoda byla úspěšná. Záznam výjimky byl zkopírován do výstupní vyrovnávací paměti. |
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) |
K cíli není přidružený žádný záznam výjimky. |
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) |
Velikost vstupní vyrovnávací paměti se nerovná sizeof(MINIDUMP_EXCEPTION). |
Poznámky
MINIDUMP_EXCEPTION je struktura definovaná v dbghelp.h a imagehlp.h v sadě Windows SDK.
Tato metoda je implementována zapisovačem ladicí aplikace.
Požadavky
Platformy: Viz požadavky na systém.
Hlavička: ClrData.idl, ClrData.h
Knihovna: CorGuids.lib
Verze rozhraní .NET Framework: K dispozici od listopadu 2013 aktualizace na verzi 4.5.1
