Metode ICLRPolicyManager::SetDefaultAction

Artikel
05/10/2023

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

Sintaks

HRESULT SetDefaultAction (  
    [in] EClrOperation operation,  
    [in] EPolicyAction action  
);

Parameter

operation
[in] Salah satu nilai EClrOperation, menunjukkan tindakan di mana perilaku CLR harus disesuaikan.

action
[in] Salah satu nilai EPolicyAction, menunjukkan tindakan kebijakan yang harus diambil CLR ketika operation terjadi.

Tampilkan Nilai

HRESULT	Deskripsi
S_OK	`SetDefaultAction` 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	`action` tidak valid ditentukan untuk `operation`, atau nilai yang tidak valid disediakan untuk `operation`.

Keterangan

Tidak semua nilai tindakan kebijakan dapat ditentukan sebagai perilaku default untuk operasi CLR. SetDefaultAction biasanya hanya dapat digunakan untuk meningkatkan perilaku. Misalnya, host dapat menentukan bahwa pembatalan utas diubah menjadi pembatalan utas kasar, tetapi tidak dapat menentukan sebaliknya. Tabel di bawah ini menjelaskan nilai action yang valid untuk setiap kemungkinan nilai operation.

Nilai untuk `operation`	Nilai yang valid untuk `action`
OPR_ThreadAbort	- eAbortThread - eRudeAbortThread - eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_ThreadRudeAbortInNonCriticalRegion OPR_ThreadRudeAbortInCriticalRegion	- eRudeAbortThread - eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_AppDomainUnload	- eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_AppDomainRudeUnload	- eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_ProcessExit	- eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_FinalizerRun	- eNoAction - eAbortThread - eRudeAbortThread - eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime

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