Metode ITaskTrigger::SetTrigger (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.] ]
Metode SetTrigger mengatur kriteria pemicu untuk pemicu tugas.
Sintaks
HRESULT SetTrigger(
[in] const PTASK_TRIGGER pTrigger
);
Parameter
[in] pTrigger
Penunjuk ke struktur TASK_TRIGGER yang berisi nilai yang menentukan pemicu tugas baru.
Nilai kembali
Metode SetTrigger mengembalikan salah satu nilai berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Operasi berhasil. |
|
Argumen tidak valid. |
|
Memori tidak cukup tersedia. |
Keterangan
Anggota wBeginDay, wBeginMonth, dan wBeginYear dari struktur TASK_TRIGGER harus diatur ke hari, bulan, dan tahun yang valid masing-masing.
Tugas dapat memiliki sejumlah pemicu yang terkait dengannya. Waktu yang akan dijalankan tugas adalah gabungan dari semua pemicu yang ditentukan untuk tugas tersebut.
Untuk memperbarui tugas dengan pengaturan pemicu baru ini, aplikasi harus memanggil metode IPersistFile::Save setelah memanggil SetTrigger.
Contoh
Kode berikut menunjukkan deklarasi variabel dan sintaks panggilan untuk metode ini, termasuk anggota TASK_TRIGGER yang diperlukan. Mengatur kriteria pemicu saat membuat pemicu baru, lihat Membuat Pemicu Baru.
HRESULT hr = S_OK;
TASK_TRIGGER Trigger;
ZeroMemory(&Trigger, sizeof(TASK_TRIGGER));
Trigger.cbTriggerSize = sizeof(TASK_TRIGGER);
Trigger.wBeginDay = 1;
Trigger.wBeginMonth = 1;
Trigger.wBeginYear = 1999;
// pITaskTrigger is a previously assigned ITaskTrigger pointer.
hr = pITaskTrigger->SetTrigger(&Trigger);
if (FAILED(hr))
{
printf("Failed SetTrigger\n");
exit(1);
}
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 |