IRegisteredTask::Run method (taskschd.h)

Artikel
07/16/2024

Menjalankan tugas terdaftar segera.

Sintaksis

HRESULT Run(
  [in]            VARIANT      params,
  [out, optional] IRunningTask **ppRunningTask
);

Parameter

[in] params

Parameter yang digunakan sebagai nilai dalam tindakan tugas. Untuk tidak menentukan nilai parameter apa pun untuk tindakan tugas, atur parameter ini ke VT_NULL atau VT_EMPTY. Jika tidak, nilai BSTR tunggal atau array nilai BSTR dapat ditentukan.

Nilai BSTR yang Anda tentukan dipasangkan dengan nama dan disimpan sebagai pasangan nilai nama. Jika Anda menentukan satu nilai BSTR, maka Arg0 akan menjadi nama yang ditetapkan ke nilai . Nilai dapat digunakan dalam tindakan tugas di mana variabel $(Arg0) digunakan dalam properti tindakan.

Jika Anda meneruskan nilai seperti "0", "100", dan "250" sebagai array nilai BSTR, maka "0" akan menggantikan variabel $(Arg0), "100" akan menggantikan variabel $(Arg1), dan "250" akan menggantikan variabel $(Arg2) yang digunakan dalam properti tindakan.

Maksimum 32 nilai BSTR dapat ditentukan.

Untuk informasi selengkapnya dan daftar properti tindakan yang dapat menggunakan variabel $(Arg0), $(Arg1), ..., $(Arg32) dalam nilainya, lihat Tindakan Tugas.

[out, optional] ppRunningTask

Antarmuka IRunningTask yang menentukan instans tugas baru.

Berikan referensi ke nullIRunningTask penunjuk antarmuka. Mereferensikan pointer NULL non-dapat menyebabkan kebocoran memori karena pointer akan ditimpa.

Mengembalikan nilai

Jika metode ini berhasil, metode ini mengembalikan S_OK. Jika tidak, kode kesalahan HRESULT.

Komentar

Metode ini akan kembali tanpa kesalahan, tetapi tugas tidak akan berjalan jika properti AllowDemandStart ITaskSettings diatur ke false untuk tugas.

Fungsi IRegisteredTask::Run setara dengan fungsi IRegisteredTask::RunEx dengan parameter bendera sama dengan 0 dan parameter pengguna sama dengan NULL.

Jika IRegisteredTask::Run dipanggil dari tugas yang dinonaktifkan, itu akan mengembalikan SCHED_E_TASK_DISABLED.

Persyaratan

Syarat	Nilai
klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Platform Target	Windows
Header	taskschd.h
Pustaka	Taskschd.lib
DLL	Taskschd.dll

Lihat juga

IRegisteredTask

Penjadwal Tugas

Bagikan melalui