Bagikan melalui


Metode ICLRDataTarget3::GetExceptionContextRecord

Dipanggil oleh layanan akses data runtime bahasa umum (CLR) untuk mengambil catatan konteks yang terkait dengan proses target. Misalnya, untuk target crash dump, ini akan sama dengan catatan konteks yang diteruskan melalui argumen ExceptionParam ke fungsi MiniDumpWriteDump di Pustaka Bantuan Debug Windows (DbgHelp).

Sintaks

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

Parameter

bufferSize [di] Ukuran buffer input, dalam byte. Ini harus cukup besar untuk mengakomodasi catatan konteks.

bufferUsed [out] Penunjuk ke ULONG32 jenis yang menerima jumlah byte yang benar-benar ditulis ke buffer.

buffer [out] Penunjuk ke buffer memori yang menerima salinan rekaman konteks. Catatan pengecualian dikembalikan sebagai jenis CONTEXT.

Tampilkan Nilai

Nilai yang dikembalikan adalah S_OK jika berhasil, atau kode HRESULT gagal jika gagal. Kode HRESULT dapat mencakup namun tidak terbatas pada hal berikut:

Mengembalikan kode Deskripsi
S_OK Metode berhasil. Catatan konteks telah disalin ke buffer output.
HRESULT_FROM_WIN32(ERROR_NOT_FOUND) Tidak ada catatan konteks yang terkait dengan target.
HRESULT_FROM_WIN32(ERROR_BAD_LENGTH) Ukuran buffer input tidak cukup besar untuk mengakomodasi catatan konteks.

Keterangan

CONTEXT adalah struktur khusus platform yang ditentukan dalam header yang disediakan oleh SDK Windows.

Metode ini diimplementasikan oleh penulis aplikasi penelusuran kesalahan.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: ClrData.idl, ClrData.h

Pustaka: CorGuids.lib

Versi .NET Framework: Tersedia sejak November 2013 pembaruan ke 4.5.1

Lihat juga