Metode IShellTaskScheduler::AddTask (shobjidl_core.h)

Menambahkan tugas ke antrean latar belakang penjadwal.

Sintaks

HRESULT AddTask(
  [in] IRunnableTask  *prt,
  [in] REFTASKOWNERID rtoid,
  [in] DWORD_PTR      lParam,
  [in] DWORD          dwPriority
);

Parameter

[in] prt

Jenis: IRunnableTask*

Penunjuk ke instans antarmuka IRunnableTask yang mewakili tugas untuk ditambahkan ke antrean.

[in] rtoid

Jenis: REFTASKOWNERID

GUID yang mengidentifikasi pemilik tugas. Informasi ini dapat digunakan untuk mengelompokkan tugas untuk penghitungan atau penghapusan nanti oleh pemilik.

[in] lParam

Jenis: DWORD_PTR

Penunjuk ke nilai DWORD yang ditentukan pengguna yang memungkinkan tugas diidentifikasi dalam tugas yang dimiliki oleh rtoid. Ini digunakan untuk mengidentifikasi tugas tunggal atau untuk subgrup, misalnya mengaitkan tugas dengan item tertentu seperti item dalam ListView. Parameter ini bisa nol.

[in] dwPriority

Jenis: DWORD

Salah satu nilai berikut yang menetapkan prioritas tugas. Respons terhadap prioritas ini tergantung pada kerja sama tugas lain yang dijalankan. Tugas baru disisipkan dalam antrean dalam urutan prioritas. Jika tugas dengan prioritas rendah saat ini sedang dieksekusi saat tugas prioritas yang lebih tinggi ditambahkan, penjadwal mencoba menangguhkan tugas di bawah eksekusi. Tugas prioritas yang lebih rendah tersebut dilanjutkan ketika tugas prioritas yang lebih tinggi selesai.

ITSAT_DEFAULT_PRIORITY

Terima prioritas default yang ditetapkan ke tugas oleh penjadwal.

ITSAT_MAX_PRIORITY

Prioritas tinggi.

ITSAT_MIN_PRIORITY

Prioritas rendah.

Nilai kembali

Jenis: HRESULT

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows 2000 Professional [hanya aplikasi desktop]
Server minimum yang didukung	Windows 2000 Server [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)
DLL	Shell32.dll (versi 5.0 atau yang lebih baru)