Metode ITaskFolder::RegisterTask (taskschd.h)
Mendaftarkan (membuat) tugas baru di folder menggunakan XML untuk menentukan tugas.
Sintaksis
HRESULT RegisterTask(
[in] BSTR path,
[in] BSTR xmlText,
[in] LONG flags,
[in] VARIANT userId,
[in] VARIANT password,
[in] TASK_LOGON_TYPE logonType,
[in, optional] VARIANT sddl,
[out] IRegisteredTask **ppTask
);
Parameter
[in] path
Nama tugas. Jika nilai ini NULL, tugas akan didaftarkan di folder tugas akar dan nama tugas akan menjadi nilai GUID yang dibuat oleh layanan Task Scheduler.
Nama tugas tidak dapat dimulai atau diakhir dengan karakter spasi. Karakter '.' tidak dapat digunakan untuk menentukan folder tugas saat ini dan '..' karakter tidak dapat digunakan untuk menentukan folder tugas induk di jalur.
[in] xmlText
Definisi tugas yang diformat XML.
Topik berikut berisi tugas yang ditentukan menggunakan XML.
-
Contoh Pemicu Waktu
(XML) -
Contoh Pemicu Peristiwa (XML)
- Contoh Pemicu Harian (XML)
-
Contoh Pemicu Pendaftaran
(XML) - Contoh Pemicu Mingguan (XML)
- Contoh Pemicu Masuk (XML)
-
Contoh Pemicu Boot
(XML)
[in] flags
Konstanta TASK_CREATION.
[in] userId
Kredensial pengguna yang digunakan untuk mendaftarkan tugas.
[in] password
Kata sandi untuk userId yang digunakan untuk mendaftarkan tugas. Ketika jenis masuk TASK_LOGON_SERVICE_ACCOUNT digunakan, kata sandi harus berupa nilai VARIAN
[in] logonType
Nilai yang menentukan teknik masuk apa yang digunakan untuk menjalankan tugas terdaftar.
[in, optional] sddl
Deskriptor keamanan yang terkait dengan tugas terdaftar. Anda dapat menentukan daftar kontrol akses (ACL) di deskriptor keamanan untuk tugas untuk mengizinkan atau menolak akses pengguna dan grup tertentu ke tugas.
[out] ppTask
Antarmuka IRegisteredTask
Berikan referensi ke nullIRegisteredTask penunjuk antarmuka. Mereferensikan pointer NULL non-
Mengembalikan nilai
Metode ini dapat mengembalikan salah satu nilai ini.
Mengembalikan kode/nilai | Deskripsi |
---|---|
|
Operasi berhasil diselesaikan. |
|
Akses ditolak untuk tersambung ke layanan Penjadwal Tugas. |
|
Aplikasi tidak memiliki cukup memori untuk menyelesaikan operasi atau pengguna |
|
Tugas didaftarkan, tetapi mungkin gagal dimulai. Hak istimewa masuk batch perlu diaktifkan untuk perwakilan tugas. |
|
Tugas terdaftar, tetapi tidak semua pemicu yang ditentukan akan memulai tugas. |
Komentar
Untuk tugas, yang berisi tindakan kotak pesan, kotak pesan akan ditampilkan jika tugas diaktifkan dan tugas memiliki jenis masuk interaktif. Untuk mengatur jenis masuk tugas menjadi interaktif, tentukan
Hanya anggota grup Administrator yang dapat membuat tugas dengan pemicu boot.
Anda dapat berhasil mendaftarkan tugas dengan grup yang ditentukan dalam parameter userId
Meneruskan nilai TASK_VALIDATE_ONLY dan TASK_IGNORE_REGISTRATION_TRIGGERS bersama-sama ke parameter bendera
Jika tugas menentukan jaringan yang tidak ada di pengaturan NetworkSettings tugas, metode ITaskFolder::RegisterTask akan mengembalikan kesalahan 0x8000ffff ketika tugas didaftarkan.
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
ITaskFolder
Penjadwal Tugas
Saran dan Komentar
https://aka.ms/ContentUserFeedback.
Segera hadir: Sepanjang tahun 2024 kami akan menghentikan penggunaan GitHub Issues sebagai mekanisme umpan balik untuk konten dan menggantinya dengan sistem umpan balik baru. Untuk mengetahui informasi selengkapnya, lihat:Kirim dan lihat umpan balik untuk