Metode IScheduledWorkItem::SetIdleWait (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.] ]

Mengatur menit sistem harus menganggur sebelum item kerja dapat berjalan.

Sintaks

HRESULT SetIdleWait(
  [in] WORD wIdleMinutes,
  [in] WORD wDeadlineMinutes
);

Parameter

[in] wIdleMinutes

Nilai yang menentukan berapa lama, dalam menit, sistem harus tetap menganggur sebelum item kerja dapat berjalan.

[in] wDeadlineMinutes

Nilai yang menentukan jumlah menit maksimum penjadwal Tugas akan menunggu periode idle-time yang dikembalikan dalam pwIdleMinutes.

Nilai kembali

Metode SetIdleWait mengembalikan S_OK.

Keterangan

Waktu menganggur yang ditentukan di sini digunakan bersama dengan pemicu diam dan kondisi menganggur. Untuk informasi selengkapnya, lihat Kondisi Menganggur Tugas. Pemicu diam adalah pemicu berbasis peristiwa yang tidak terkait dengan waktu terjadwal. Kondisi menganggur, sebaliknya, dikaitkan dengan waktu mulai terjadwal untuk tugas.

Anda menentukan pemicu diam dengan mengatur anggota TASK_TRIGGER_TYPE TASK_TRIGGER ke TASK_EVENT_TRIGGER_ON_IDLE. Pemicu diam diaktifkan ketika sistem menjadi diam selama jumlah waktu yang ditentukan oleh wIdleMinutes.

Anda mengatur kondisi diam dengan memanggil IScheduledWorkItem::SetFlags. Jika bendera TASK_FLAG_START_ONLY_IF_IDLE diatur, item kerja berjalan pada waktu yang dijadwalkan hanya jika sistem menjadi diam selama jumlah waktu yang ditentukan oleh wIdleMinutes. Layanan Penjadwal Tugas akan menunggu hingga jumlah menit yang ditentukan dalam wDeadlineMinutes melewati waktu mulai yang dijadwalkan untuk melihat apakah sistem menjadi menganggur.

Aplikasi harus memanggil metode IPersistFile::Save setelah memanggil SetIdleWait untuk memperbarui interval tunggu diam.

Contoh

Untuk contoh cara mengatur waktu tunggu diam saat membuat pemicu diam, lihat Membuat Contoh Pemicu Menganggur.

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

IScheduledWorkItem

IScheduledWorkItem::GetIdleWait