Metode IScheduledWorkItem::SetFlags (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 bendera yang mengubah perilaku semua jenis item kerja.
Sintaks
HRESULT SetFlags(
DWORD dwFlags
);
Parameter
dwFlags
Nilai yang menentukan kombinasi satu atau beberapa bendera berikut:
TASK_FLAG_INTERACTIVE
Bendera ini digunakan saat mengonversi pekerjaan layanan Windows NT AT menjadi item kerja. Pekerjaan layanan Windows NT AT mengacu pada At.exe, utilitas baris perintah Windows NT yang digunakan untuk membuat pekerjaan untuk layanan Jadwal Windows NT. Layanan Penjadwal Tugas menggantikan layanan Jadwal dan kompatibel mundur dengannya. Konversi terjadi ketika Penjadwal Tugas diinstal pada Windows NT/Windows 2000— misalnya, jika Anda menginstal Internet Explorer 4.0, atau memutakhirkan ke Windows 2000. Selama proses penyiapan, kode penginstalan Task Scheduler mencari registri untuk pekerjaan yang dibuat untuk layanan AT dan membuat item kerja yang akan menyelesaikan operasi yang sama.
Untuk pekerjaan yang dikonversi tersebut, bendera interaktif diatur jika item kerja dimaksudkan untuk ditampilkan kepada pengguna. Ketika bendera ini tidak diatur, tidak ada item kerja yang ditampilkan di folder Tugas, dan tidak ada antarmuka pengguna yang terkait dengan item kerja yang disajikan kepada pengguna ketika item kerja dijalankan.
TASK_FLAG_DELETE_WHEN_DONE
Item kerja akan dihapus ketika tidak ada lagi durasi terjadwal.
TASK_FLAG_DISABLED
Item kerja dinonaktifkan. Ini berguna untuk mencegah sementara item kerja berjalan pada waktu yang dijadwalkan.
TASK_FLAG_HIDDEN
Item kerja yang dibuat akan disembunyikan.
TASK_FLAG_RUN_ONLY_IF_LOGGED_ON
Item kerja hanya berjalan jika pengguna yang ditentukan dalam IScheduledWorkItem::SetAccountInformation dicatat secara interaktif. Bendera ini tidak berpengaruh pada item kerja yang diatur untuk dijalankan di akun lokal.
TASK_FLAG_START_ONLY_IF_IDLE
Item kerja dimulai hanya jika komputer tidak digunakan pada waktu mulai yang dijadwalkan.
TASK_FLAG_SYSTEM_REQUIRED
Item kerja menyebabkan sistem dilanjutkan, atau terbangun, jika sistem berjalan dengan daya baterai. Bendera ini hanya didukung pada sistem yang mendukung timer resume.
TASK_FLAG_KILL_ON_IDLE_END
Item kerja berakhir jika komputer melakukan transisi diam ke non-diam saat item kerja sedang berjalan. Komputer tidak dianggap menganggur sampai waktu pemicu IdleWait berlalu tanpa input pengguna. Untuk informasi mengenai pemicu diam, lihat Pemicu Menganggur.
TASK_FLAG_RESTART_ON_IDLE_RESUME
Item kerja dimulai lagi jika komputer membuat transisi non-diam ke diam sebelum semua item kerja task_triggers berlalu. (Gunakan bendera ini bersama dengan TASK_FLAG_KILL_ON_IDLE_END.)
TASK_FLAG_DONT_START_IF_ON_BATTERIES
Item kerja tidak dimulai jika komputer targetnya berjalan pada daya baterai.
TASK_FLAG_KILL_IF_GOING_ON_BATTERIES
Item kerja berakhir, dan aplikasi terkait berhenti jika komputer target item kerja beralih ke daya baterai.
TASK_FLAG_RUN_IF_CONNECTED_TO_INTERNET
Item kerja hanya berjalan jika saat ini ada koneksi Internet yang valid.
Nilai kembali
Metode SetFlags mengembalikan salah satu nilai berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Operasi berhasil. |
|
Argumen tidak valid. |
|
Memori tidak cukup tersedia. |
Keterangan
Program harus memanggil metode IPersistFile::Save setelah memanggil SetFlags untuk memperbarui bendera.
Metode ini digunakan untuk mengatur bendera yang digunakan oleh semua jenis item kerja terjadwal. Sebaliknya, ITask::SetTaskFlags hanya digunakan untuk mengatur bendera yang digunakan oleh tugas terjadwal.
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 |