ICLRDataTarget3::GetExceptionContextRecord – metoda
Volá se službou CLR (Common Language Runtime) pro přístup k datům za účelem načtení kontextového záznamu přidruženého k cílovému procesu. Například pro cíl výpisu paměti by to bylo ekvivalentní kontextovému záznamu předávaného prostřednictvím ExceptionParam argumentu funkce MiniDumpWriteDump v knihovně nápovědy ladění systému Windows (DbgHelp).
Syntaxe
HRESULT GetExceptionContextRecord(
[in] ULONG32 bufferSize,
[out] ULONG32* bufferUsed,
[out, size_is(bufferSize)] BYTE* buffer
);
Parametry
bufferSize [v] Velikost vstupní vyrovnávací paměti v bajtech. Musí to být dostatečně velké, aby vyhovovalo kontextu záznamu.
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 kontextového záznamu. Záznam výjimky se vrátí jako typ CONTEXT .
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á. Kontextový záznam 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ý kontextový záznam. |
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) |
Velikost vstupní vyrovnávací paměti není dostatečně velká pro přizpůsobení kontextového záznamu. |
Poznámky
CONTEXT je struktura specifická pro platformu definovaná v hlavičkách poskytovaných sadou 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
