Metode ITask::SetMaxRunTime (mstask.h)
[[API ini dapat diubah atau tidak tersedia dalam versi sistem operasi atau produk berikutnya. Silakan gunakan Antarmuka Penjadwal Tugas 2.0 sebagai gantinya.] ]
Metode ini mengatur waktu maksimum tugas dapat berjalan, dalam milidetik, sebelum mengakhiri.
Sintaks
HRESULT SetMaxRunTime(
[in] DWORD dwMaxRunTimeMS
);
Parameter
[in] dwMaxRunTimeMS
Nilai DWORD yang menentukan durasi maksimum (dalam milidetik), untuk tugas tersebut. Parameter ini dapat diatur ke INFINITE untuk menentukan waktu yang tidak terbatas.
Nilai kembali
Metode SetMaxRunTime mengembalikan salah satu nilai berikut.
Menampilkan kode | Deskripsi |
---|---|
|
Operasi berhasil. |
|
Argumen tidak valid. |
|
Tidak tersedia cukup memori. |
Keterangan
Ketika durasi maksimum terlampaui, Penjadwal Tugas mencoba mengakhiri aplikasi yang terkait dengan tugas. Jika pesan WM_CLOSE tidak dapat dikirim (misalnya, aplikasi tidak memiliki jendela) atau aplikasi belum keluar dalam waktu tiga menit setelah menerima WM_CLOSE, Task Scheduler mengakhiri aplikasi menggunakan TerminateProcess.
Setelah mengatur durasi maksimum, pastikan untuk memanggil IPersistFile::Simpan untuk menyimpan objek tugas yang dimodifikasi ke disk.
Contoh
Untuk contoh cara mengatur waktu proses maksimum, lihat Contoh Kode C/C++: Mengatur MaxRunTime.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
Target Platform | Windows |
Header | mstask.h |
Pustaka | Mstask.lib |
DLL | Mstask.dll |
Redistribusi | Internet Explorer 4.0 atau yang lebih baru pada Windows NT 4.0 dan Windows 95 |