Metode IScheduledWorkItem::CreateTrigger (mstask.h)

Artikel
03/05/2024

[[API ini dapat diubah atau tidak tersedia dalam versi sistem operasi atau produk berikutnya. Silakan gunakan Antarmuka Penjadwal Tugas 2.0 sebagai gantinya.] ]

Membuat pemicu untuk item kerja.

Sintaks

HRESULT CreateTrigger(
  [out] WORD         *piNewTrigger,
  [out] ITaskTrigger **ppTrigger
);

Parameter

[out] piNewTrigger

Penunjuk ke nilai indeks pemicu yang dikembalikan dari pemicu baru. Indeks pemicu untuk pemicu pertama yang terkait dengan item kerja adalah "0". Lihat Keterangan untuk penggunaan lain dari indeks pemicu.

[out] ppTrigger

Penunjuk ke penunjuk ke antarmuka ITaskTrigger . Saat ini, satu-satunya item kerja yang didukung adalah tugas.

Nilai kembali

Metode CreateTrigger mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
E_INVALIDARG	Argumen tidak valid.
E_OUTOFMEMORY	Memori tidak cukup tersedia.

Keterangan

Anda menggunakan indeks pemicu yang dikembalikan oleh piNewTrigger saat Anda mengambil atau menghapus pemicu. Namun, indeks pemicu bukan pengidentifikasi. Ini hanya menunjukkan posisi pemicu baru yang relatif terhadap pemicu saat ini lainnya yang terkait dengan item kerja.

Untuk mengatur kriteria pemicu baru, panggil ITaskTrigger::SetTrigger.

Setelah membuat pemicu baru untuk item kerja, aplikasi harus memanggil metode IPersistFile::Save untuk menyimpan pemicu baru ke disk.

Contoh

Untuk contoh cara mengatur kriteria pemicu saat membuat pemicu baru, lihat Membuat Pemicu Baru.

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