Metode ITask::SetMaxRunTime (mstask.h)

  • Artikel

[[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
S_OK
 Operasi berhasil.
E_INVALIDARG
 Argumen tidak valid.
E_OUTOFMEMORY
 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

Lihat juga

IGetMaxRunTime

ITask