Metode ITaskTrigger::SetTrigger (mstask.h)

Artikel
03/09/2024

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