struktur TASK_TRIGGER (mstask.h)

Artikel
03/15/2023

Menentukan waktu untuk menjalankan item kerja terjadwal.

Sintaks

typedef struct _TASK_TRIGGER {
  WORD               cbTriggerSize;
  WORD               Reserved1;
  WORD               wBeginYear;
  WORD               wBeginMonth;
  WORD               wBeginDay;
  WORD               wEndYear;
  WORD               wEndMonth;
  WORD               wEndDay;
  WORD               wStartHour;
  WORD               wStartMinute;
  DWORD              MinutesDuration;
  DWORD              MinutesInterval;
  DWORD              rgFlags;
  TASK_TRIGGER_TYPE  TriggerType;
  TRIGGER_TYPE_UNION Type;
  WORD               Reserved2;
  WORD               wRandomMinutesInterval;
} TASK_TRIGGER, *PTASK_TRIGGER;

Anggota

cbTriggerSize

Ukuran struktur ini, dalam byte.

Reserved1

Hanya untuk penggunaan internal; nilai ini harus nol.

wBeginYear

Tahun pemicu tugas diaktifkan. Nilai ini harus empat digit (1997, bukan 97). Tahun awal harus ditentukan saat mengatur tugas.

wBeginMonth

Bulan dalam setahun (ditentukan dalam anggota wBeginYear ) yang diaktifkan pemicu tugas. Bulan awal harus ditentukan saat mengatur tugas.

wBeginDay

Hari dalam sebulan (ditentukan dalam anggota wBeginMonth ) yang diaktifkan pemicu tugas. Hari awal harus ditentukan saat mengatur tugas.

wEndYear

Tahun pemicu tugas dinonaktifkan. Nilai ini harus empat digit (1997, bukan 97).

wEndMonth

Bulan dalam setahun (ditentukan dalam anggota wEndYear ) yang dinonaktifkan oleh pemicu tugas.

wEndDay

Hari dalam sebulan (ditentukan dalam anggota wEndMonth ) yang dinonaktifkan oleh pemicu tugas.

wStartHour

Jam dalam sehari tugas berjalan. Nilai ini berada pada jam 24 jam; jam berjalan dari 00 hingga 23.

wStartMinute

Menit dalam satu jam (ditentukan dalam anggota wStartHour ) yang dijalankan tugas.

MinutesDuration

Jumlah menit setelah tugas dimulai bahwa pemicu akan tetap aktif. Jumlah menit yang ditentukan di sini harus lebih besar dari atau sama dengan pengaturan MinutesInterval .

Misalnya, jika Anda memulai tugas pada pukul 8:00 A.M. dan ingin berulang kali memulai tugas hingga pukul 17.00, akan ada 540 menit dalam durasi.

MinutesInterval

Jumlah menit antara eksekusi tugas berturut-turut. Jumlah ini dihitung dari awal tugas terjadwal sebelumnya. Jumlah menit yang ditentukan di sini harus kurang dari pengaturan MinutesDuration .

Misalnya, untuk menjalankan tugas setiap jam dari pukul 8:00 A.M. hingga 17:00, atur bidang ini ke 60.

rgFlags

Nilai yang menjelaskan perilaku pemicu. Nilai ini adalah kombinasi dari bendera berikut.

TASK_TRIGGER_FLAG_HAS_END_DATE

Tanggal selesai struktur pemicu valid. Jika bendera ini tidak diatur, data tanggal akhir diabaikan dan pemicu akan valid tanpa batas waktu.

TASK_TRIGGER_FLAG_KILL_AT_DURATION_END

Tugas akan dihentikan pada akhir masa pakai pemicu aktif. Pada akhir durasi, Penjadwal Tugas mengirim pesan WM_CLOSE ke aplikasi terkait. Jika WM_CLOSE tidak dapat dikirim (misalnya, aplikasi tidak memiliki jendela) atau aplikasi belum keluar dalam waktu tiga menit setelah menerima WM_CLOSE, Task Scheduler menghentikan aplikasi menggunakan TerminateProcess.

TASK_TRIGGER_FLAG_DISABLED

Pemicu tugas tidak aktif.

TriggerType

Nilai TASK_TRIGGER_TYPE yang dijumlahkan yang menentukan jenis pemicu. Anggota ini digunakan dengan Tipe. Jenis pemicu yang ditentukan di sini menentukan bidang mana dari TRIGGER_TYPE_UNION yang ditentukan dalam anggota Jenis yang akan digunakan. Jenis pemicu didasarkan pada kapan pemicu akan menjalankan tugas.

Type

Struktur TRIGGER_TYPE_UNION yang menentukan detail tentang pemicu. Perhatikan bahwa anggota TriggerType menentukan bidang mana dari TRIGGER_TYPE_UNION union yang akan digunakan.

Reserved2

Hanya untuk penggunaan internal; nilai ini harus nol.

wRandomMinutesInterval

Saat ini tidak digunakan.

Keterangan

Waktu ini dapat mencakup waktu mulai, waktu akhir, durasi, dan bendera modifikasi untuk item kerja. Perhatikan bahwa saat mengatur pemicu, bulan dan tahun awal hari harus diatur.

Catatan Item kerja terjadwal dapat memiliki satu atau beberapa pemicu yang ditentukan. Waktu yang akan dijalankan item kerja adalah gabungan semua pemicu yang ditentukan untuk item tersebut.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Header	mstask.h