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 |