Metode ICLRPolicyManager::SetActionOnFailure

Artikel
04/08/2023

Menentukan tindakan kebijakan yang harus dilakukan runtime bahasa umum (CLR) ketika kegagalan yang ditentukan terjadi.

Sintaks

HRESULT SetActionOnFailure (  
    [in] EClrFailure   failure,  
    [in] EPolicyAction action  
);

Parameter

failure
[in] Salah satu nilai EClrFailure, menunjukkan jenis kegagalan yang harus diambil tindakannya.

action
[in] Salah satu nilai EPolicyAction, menunjukkan tindakan yang akan diambil ketika kegagalan terjadi. Untuk daftar nilai yang didukung, lihat bagian Keterangan.

Tampilkan Nilai

HRESULT	Deskripsi
S_OK	`SetActionOnFailure` berhasil dikembalikan.
HOST_E_CLRNOTAVAILABLE	Runtime bahasa umum belum dimuat ke dalam proses, atau runtime bahasa umum dalam status yaitu tidak dapat menjalankan kode aman atau memproses panggilan dengan sukses.
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. Saat metode menampilkan E_FAIL, CLR tidak lagi dapat digunakan dalam proses. Panggilan berikutnya ke metode hosting menampilkan HOST_E_CLRNOTAVAILABLE.
E_INVALIDARG	Tindakan kebijakan tidak dapat ditetapkan untuk operasi yang ditentukan, atau tindakan kebijakan yang tidak valid ditentukan untuk operasi tersebut.

Keterangan

Secara default, CLR melempar pengecualian ketika gagal mengalokasikan sumber daya seperti memori. SetActionOnFailure memungkinkan host mengambil alih perilaku ini dengan menentukan tindakan kebijakan yang akan diambil setelah kegagalan. Tabel berikut ini memperlihatkan kombinasi nilai EClrFailure (kolom) dan EPolicyAction (baris) yang didukung.

	`FAIL_NonCriticalResource`	`FAIL_CriticalResource`	`FAIL_FatalRuntime`	`FAIL_OrphanedLock`	`FAIL_StackOverflow`	`FAIL_AccessViolation`	`FAIL_CodeContract`
`eNoAction`	X	X				T/A
`eThrowException`	X	X				T/A
`eAbortThread`	X	X				T/A	X
`eRudeAbortThread`	X	X				T/A	X
`eUnloadAppDomain`	X	X		X		T/A	X
`eRudeUnloadAppDomain`	X	X		X	X	T/A	X
`eExitProcess`	X	X		X	X	T/A	X
`eFastExitProcess`	X	X		X	X	T/A
`eRudeExitProcess`	X	X	X	X	X	T/A
`eDisableRuntime`	X	X	X	X	X	T/A

Persyaratan

Platform: Lihat Persyaratan Sistem.

Header: MSCorEE.h

Pustaka: Disertakan sebagai sumber daya di MSCorEE.dll

Versi .NET Framework: Tersedia mulai dari 2.0

Bagikan melalui