Bagikan melalui

Metode IActionOnCLREvent::OnEvent

Melakukan panggilan balik pada peristiwa yang telah didaftarkan dengan menggunakan panggilan ke metode ICLROnEventManager::RegisterActionOnEvent.

Sintaks

HRESULT OnEvent (  
    [in] EClrEvent event,  
    [in] PVOID     data  
);

Parameter

event
[in] Salah satu nilai EClrEvent, yang menunjukkan jenis peristiwa.

data
[in] Penunjuk ke objek yang berisi detail tentang event.

Tampilkan Nilai

HRESULT Deskripsi
S_OK OnEvent berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE Runtime bahasa umum (CLR) belum dimuat ke dalam proses, atau CLR berada dalam status yang tidak dapat menjalankan kode terkelola atau tidak berhasil memproses panggilan.
HOST_E_TIMEOUT Waktu panggilan habis.
HOST_E_NOT_OWNER Pemanggil tidak memiliki kunci.
HOST_E_ABANDONED Peristiwa dibatalkan saat rangkaian atau fiber yang diblokir sedang menunggunya.
E_FAIL Terjadi kegagalan bencana yang tidak diketahui. Jika metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting apa pun menampilkan HOST_E_CLRNOTAVAILABLE.

Keterangan

Parameter data adalah penunjuk ke objek dari jenis yang tidak ditentukan. Jika parameter event adalah Event_DomainUnload, data adalah pengidentifikasi numerik untuk AppDomain yang dibongkar. Host dapat mengambil tindakan yang sesuai menggunakan pengidentifikasi ini sebagai kunci.

Jika event adalah Event_MDAFired, data adalah penunjuk ke instans MDAInfo yang berisi output pesan dari Asisten Penelusuran Kesalahan Terkelola (MDA). MDA adalah fitur CLR yang membantu pengembang melakukan penelusuran kesalahan, dengan menghasilkan pesan XML tentang peristiwa yang sulit dijebak. Pesan tersebut dapat sangat berguna dalam menelusuri kesalahan transisi antara kode terkelola dan tak terkelola. Untuk informasi selengkapnya, lihat Mendiagnosis Kesalahan dengan Asisten Penelusuran Kesalahan Terkelola.

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Lihat juga

  • Last updated on