IRegisteredTask::Run method (taskschd.h)

  • Artikel

Menjalankan tugas terdaftar segera.

Sintaks

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, satu nilai BSTR atau array nilai BSTR dapat ditentukan.

Nilai BSTR yang Anda tentukan dipasangkan dengan nama dan disimpan sebagai pasangan nama-nilai. 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.

Maksimal 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 baru tugas.

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

Menampilkan nilai

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

Keterangan

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

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, IRegisteredTask::Run dipanggil dari tugas yang dinonaktifkan, IRegisteredTask akan mengembalikan SCHED_E_TASK_DISABLED.

Persyaratan

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

Lihat juga

IRegisteredTask

Tugas Microsoft Azure Scheduler