Udostępnij za pośrednictwem

Metoda ICLRDataTarget3::GetExceptionContextRecord

  • Artykuł

Wywoływane przez usługi dostępu do danych środowiska uruchomieniowego języka wspólnego (CLR) w celu pobrania rekordu kontekstu skojarzonego z procesem docelowym. Na przykład w przypadku obiektu docelowego zrzutu będzie to odpowiednik rekordu kontekstu przekazanego ExceptionParam za pośrednictwem argumentu do funkcji MiniDumpWriteDump w bibliotece pomocy debugowania systemu Windows (DbgHelp).

Składnia

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

Parametry

bufferSize
[w] Rozmiar buforu wejściowego w bajtach. Musi to być wystarczająco duże, aby pomieścić rekord kontekstu.

bufferUsed
[out] Wskaźnik do ULONG32 typu, który odbiera liczbę bajtów rzeczywiście zapisanych w buforze.

buffer
[out] Wskaźnik do buforu pamięci, który odbiera kopię rekordu kontekstu. Rekord wyjątku jest zwracany jako typ KONTEKSTU .

Wartość zwracana

Wartość zwracana jest S_OK w przypadku powodzenia lub kodu błędu po niepowodzeniu HRESULT . Kody HRESULT mogą zawierać, ale nie są ograniczone do następujących elementów:

Kod powrotu Opis
S_OK Metoda powiodła się. Rekord kontekstu został skopiowany do buforu wyjściowego.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Żaden rekord kontekstu nie jest skojarzony z obiektem docelowym.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) Rozmiar buforu wejściowego nie jest wystarczająco duży, aby pomieścić rekord kontekstu.

Uwagi

CONTEXT to struktura specyficzna dla platformy zdefiniowana w nagłówkach udostępnianych przez zestaw 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

.NET Framework Wersje: dostępna od listopada 2013 r. aktualizacja do wersji 4.5.1

Zobacz też