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.

Catatan Fitur ini saat ini tidak diimplementasikan.

 

Nilai kembali

Metode SetFlags mengembalikan salah satu nilai berikut.

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

Lihat juga

IScheduledWorkItem

IScheduledWorkItem::GetFlags

IScheduledWorkItem::SetAccountInformation