Metode RegisteredTask.RunEx
Untuk pembuatan skrip, menjalankan tugas terdaftar segera menggunakan bendera tertentu dan pengidentifikasi sesi.
Sintaks
RegisteredTask.RunEx( _
ByVal params, _
ByVal flags, _
ByVal sessionID, _
ByRef runningTask _
)
Parameter
-
params [in]
-
Parameter yang digunakan sebagai nilai dalam tindakan tugas. Untuk tidak menentukan nilai parameter apa pun untuk tindakan tugas, atur parameter ini ke Tidak Ada. Jika tidak, nilai string tunggal atau array nilai string dapat ditentukan.
Nilai string yang Anda tentukan dipasangkan dengan nama dan disimpan sebagai pasangan nilai nama. Jika Anda menentukan satu nilai string, 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 string, 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 string dapat ditentukan.
Untuk informasi selengkapnya dan daftar properti tindakan yang dapat menggunakan variabel $(Arg0), $(Arg1), ..., $(Arg32) dalam nilainya, lihat Tindakan Tugas.
-
flags [in]
-
Konstanta TASK_RUN_FLAGS yang menentukan bagaimana tugas dijalankan.
-
sessionID [in]
-
Sesi server terminal tempat Anda ingin meluncurkan tugas.
Jika konstanta TASK_RUN_USE_SESSION_ID (0x4) tidak diteruskan ke parameter bendera , maka nilai yang ditentukan dalam parameter ini diabaikan. Jika konstanta TASK_RUN_USE_SESSION_ID diteruskan ke parameter bendera dan nilai sessionID kurang dari atau sama dengan 0, maka kesalahan argumen yang tidak valid akan dikembalikan.
Jika konstanta TASK_RUN_USE_SESSION_ID diteruskan ke parameter bendera dan nilai sessionID adalah ID sesi yang valid lebih besar dari 0 dan jika tidak ada nilai yang ditentukan untuk parameter pengguna , maka layanan Penjadwal Tugas akan mencoba meluncurkan tugas secara interaktif sebagai pengguna yang masuk ke sesi yang ditentukan.
Jika konstanta TASK_RUN_USE_SESSION_ID diteruskan ke parameter bendera dan nilai sessionID adalah ID sesi yang valid lebih besar dari 0 dan jika pengguna ditentukan dalam parameter pengguna , maka layanan Penjadwal Tugas akan mencoba meluncurkan tugas secara interaktif sebagai pengguna yang ditentukan dalam parameter pengguna .
-
runningTask [out]
-
Objek RunningTask yang menentukan instans baru tugas.
Nilai kembali
Metode ini tidak mengembalikan nilai.
Keterangan
Metode ini akan kembali tanpa kesalahan, tetapi tugas tidak akan berjalan jika properti TaskSettings.AllowDemandStart diatur ke false untuk tugas terdaftar.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung |
Windows Vista [hanya aplikasi desktop] |
| Server minimum yang didukung |
Windows Server 2008 [hanya aplikasi desktop] |
| Pustaka jenis |
|
| DLL |
|