Metode ITaskFolder::RegisterTaskDefinition (taskschd.h)
Mendaftarkan (membuat) tugas di lokasi tertentu menggunakan antarmuka ITaskDefinition untuk menentukan tugas.
Sintaks
HRESULT RegisterTaskDefinition(
[in] BSTR path,
[in] ITaskDefinition *pDefinition,
[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 Penjadwal Tugas.
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] pDefinition
Definisi tugas terdaftar.
[in] flags
Konstanta TASK_CREATION .
[in] userId
Kredensial pengguna yang digunakan untuk mendaftarkan tugas. Jika ada, kredensial ini lebih diprioritaskan daripada kredensial yang ditentukan dalam objek definisi tugas yang ditujukkan oleh parameter pDefinition .
[in] password
Kata sandi untuk userId yang digunakan untuk mendaftarkan tugas. Ketika jenis masuk TASK_LOGON_SERVICE_ACCOUNT digunakan, kata sandi harus merupakan nilai VARIAN kosong seperti VT_NULL atau VT_EMPTY.
[in] logonType
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 pendeskripsi keamanan untuk tugas untuk mengizinkan atau menolak akses pengguna dan grup tertentu ke tugas.
[out] ppTask
Antarmuka IRegisteredTask yang mewakili tugas baru.
Berikan referensi ke penunjuk antarmuka NULLIRegisteredTask . Mereferensikan pointer non-NULL dapat menyebabkan kebocoran memori karena pointer akan ditimpa.
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 atau kata sandi memiliki setidaknya satu null dan satu nilai bukan null . |
|
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. |
Keterangan
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 TASK_LOGON_INTERACTIVE_TOKEN atau TASK_LOGON_GROUP di properti LogonType dari prinsipal tugas, atau dalam parameter logonTypedari ITaskFolder::RegisterTask atau ITaskFolder::RegisterTaskDefinition.
Hanya anggota grup Administrator yang dapat membuat tugas dengan pemicu boot.
Anda dapat berhasil mendaftarkan tugas dengan grup yang ditentukan dalam parameter userId dan TASK_LOGON_INTERACTIVE_TOKEN yang ditentukan dalam parameter logonType dari ITaskFolder::RegisterTask atau ITaskFolder::RegisterTaskDefinition, tetapi tugas tidak akan berjalan.
Meneruskan nilai TASK_VALIDATE_ONLY dan TASK_IGNORE_REGISTRATION_TRIGGERS bersama-sama ke parameter bendera adalah argumen yang tidak valid.
Metode ITaskFolder::RegisterTaskDefinition mengembalikan kesalahan 80070534 ketika dipanggil oleh akun Sistem dengan parameter pengguna yang sama dengan NULL, parameter kata sandi yang sama dengan NULL, dan parameter logonType sama dengan TASK_LOGON_SERVICE_ACCOUNT.
Jika tugas menentukan jaringan yang tidak ada di pengaturan NetworkSettings tugas, metode ITaskFolder::RegisterTaskDefinition akan mengembalikan kesalahan 0x8000ffff ketika tugas terdaftar.
Persyaratan
Persyaratan | Nilai |
---|---|
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
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