Bagikan melalui

Struktur MDAInfo

Menyediakan detail tentang peristiwa Event_MDAFired, yang memicu pembuatan asisten penelusuran kesalahan terkelola (MDA).

Sintaks

typedef struct _MDAInfo {  
    LPCWSTR  lpMDACaption;  
    LPCWSTR  lpMDAMessage  
} MDAInfo;

Anggota

Anggota Deskripsi
lpMDACaption Judul MDA saat ini. Judul menjelaskan jenis kegagalan yang memicu peristiwa Event_MDAFired.
lpMDAMessage Pesan output yang disediakan oleh MDA saat ini.

Keterangan

Asisten penelusuran kesalahan terkelola (MDA) adalah alat bantu penelusuran kesalahan yang berfungsi bersama dengan runtime bahasa umum (CLR) untuk melakukan tugas seperti mengidentifikasi kondisi yang tidak valid di mesin eksekusi runtime atau membuang informasi tambahan tentang status mesin. MDA menghasilkan pesan XML tentang peristiwa yang sulit untuk dijebak. Mereka sangat berguna untuk menelusuri kesalahn transisi antara kode terkelola dan tidak terkelola.

Runtime mengambil langkah-langkah berikut saat peristiwa yang memicu pembuatan MDA diaktifkan:

  • Jika host belum mendaftarkan instans IActionOnCLREvent dengan memanggil ICLROnEventManager::RegisterActionOnEvent untuk diberi tahu tentang peristiwa Event_MDAFired, runtime berlanjut dengan perilaku default yang tidak dihosting.

  • Jika host telah mendaftarkan handler untuk peristiwa ini, runtime memeriksa untuk melihat apakah penelusur kesalahan dilampirkan ke proses. Jika ya, runtime masuk ke penelusur kesalahan. Ketika penelusur kesalahan berlanjut, penelusur kesalahan memanggil ke host. Jika tidak ada penelusur kesalahan yang terpasang, runtime memanggil IActionOnCLREvent::OnEvent dan meneruskan penunjuk ke instansMDAInfo sebagai parameter data.

Host dapat memilih untuk mengaktifkan MDA dan diberi tahu ketika MDA diaktifkan. Ini memberi host kesempatan untuk mengambil alih perilaku default dan membatalkan utas terkelola yang menaikkan peristiwa, untuk mencegahnya merusak status proses. Untuk informasi selengkapnya tentang menggunakan MDA, lihat Mendiagnosis Kesalahan dengan Asisten Penelusuran Kesalahan Terkelola.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.idl

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on