ICLRDataTarget3::GetExceptionRecord — Metoda
Wywoływana przez usługi dostępu do danych środowiska uruchomieniowego języka wspólnego (CLR) w celu pobrania rekordu wyjątku skojarzonego z procesem docelowym. Na przykład w przypadku obiektu docelowego zrzutu będzie to odpowiednik rekordu wyjątku przekazanego za pośrednictwem argumentu ExceptionParam do funkcji MiniDumpWriteDump w bibliotece Pomocy debugowania systemu Windows (DbgHelp).
Składnia
HRESULT GetExceptionRecord(
[in] ULONG32 bufferSize,
[out] ULONG32* bufferUsed,
[out, size_is(bufferSize] BYTE* buffer
);
Parametry
bufferSize
[in] Rozmiar buforu wejściowego w bajtach. Musi to być równe sizeof(MINIDUMP_EXCEPTION).
bufferUsed
[out] Wskaźnik do ULONG32 typu, który odbiera liczbę bajtów faktycznie zapisanych w buforze.
buffer
[out] Wskaźnik do buforu pamięci, który odbiera kopię rekordu wyjątku. Rekord wyjątku jest zwracany jako typ MINIDUMP_EXCEPTION .
Wartość zwracana
Wartość zwracana jest S_OK w przypadku powodzenia lub kodu błędu HRESULT w przypadku niepowodzenia. Kody HRESULT mogą zawierać następujące elementy, ale nie są ograniczone do następujących:
| Kod powrotu | Opis |
|---|---|
S_OK |
Metoda powiodła się. Rekord wyjątku został skopiowany do buforu wyjściowego. |
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) |
Żaden rekord wyjątku nie jest skojarzony z obiektem docelowym. |
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) |
Rozmiar buforu wejściowego nie jest równy sizeof(MINIDUMP_EXCEPTION). |
Uwagi
MINIDUMP_EXCEPTION to struktura zdefiniowana w pliku dbghelp.h i imagehlp.h w zestawie Windows SDK.
Ta metoda jest implementowana przez składnik zapisywania aplikacji debugowania.
Wymagania
Platformy: Zobacz Wymagania systemowe.
Nagłówka: ClrData.idl, ClrData.h
Biblioteki: CorGuids.lib
wersje .NET Framework: dostępne od listopada 2013 r. do wersji 4.5.1
