Metode ICLRPolicyManager::SetActionOnTimeout

Artikel
04/08/2023

Menentukan tindakan kebijakan yang harus dilakukan oleh runtime bahasa umum (CLR) saat waktu operasi yang ditentukan habis.

Sintaks

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

Parameter

operation
[in] Salah satu nilai EClrOperation, menunjukkan operasi untuk menentukan tindakan batas waktu. Nilai berikut ini didukung:

OPR_AppDomainUnload
OPR_ProcessExit
OPR_ThreadRudeAbortInCriticalRegion
OPR_ThreadRudeAbortInNonCriticalRegion

action
[in] Salah satu nilai EPolicyAction, menunjukkan tindakan kebijakan yang akan diambil ketika operasi habis.

Tampilkan Nilai

HRESULT	Deskripsi
S_OK	`SetActionOnTimeout` 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	Batas waktu tidak dapat diatur untuk `operation` yang ditentukan, atau nilai yang tidak valid disediakan untuk `operation`.

Keterangan

Nilai batas waktu dapat berupa batas waktu default yang ditetapkan oleh CLR, atau nilai yang ditentukan oleh host dalam panggilan ke metode ICLRPolicyManager::SetTimeout.

Tidak semua nilai tindakan kebijakan dapat ditentukan sebagai perilaku waktu habis untuk operasi CLR. SetActionOnTimeout biasanya hanya 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 nilai operation yang valid.

Nilai untuk `operation`	Nilai yang valid untuk `action`
OPR_ThreadRudeAbortInNonCriticalRegion OPR_ThreadRudeAbortInCriticalRegion	- eRudeAbortThread - eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_AppDomainUnload	- eUnloadAppDomain - eRudeUnloadAppDomain - eExitProcess - eFastExitProcess - eRudeExitProcess - eDisableRuntime
OPR_ProcessExit	- 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