Metode ITaskScheduler::AddWorkItem (mstask.h)

Artikel
02/29/2024

[[API ini dapat diubah atau tidak tersedia dalam versi sistem operasi atau produk berikutnya. Silakan gunakan Antarmuka Penjadwal Tugas 2.0 sebagai gantinya.] ]

Metode AddWorkItem menambahkan tugas ke jadwal tugas.

Sintaks

HRESULT AddWorkItem(
  [in] LPCWSTR            pwszTaskName,
  [in] IScheduledWorkItem *pWorkItem
);

Parameter

[in] pwszTaskName

String yang dihentikan null yang menentukan nama tugas yang akan ditambahkan. Nama tugas harus sesuai dengan konvensi penamaan file Windows NT, tetapi tidak dapat menyertakan garis miring terbelakang karena bersarang dalam objek folder tugas tidak diperbolehkan.

[in] pWorkItem

Penunjuk ke tugas untuk ditambahkan ke jadwal.

Nilai kembali

Metode AddWorkItem mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
ERROR_FILE_EXISTS	Tugas dengan nama yang ditentukan sudah ada. Nilai pengembalian aktual adalah HRESULT_FROM_WIN32(ERROR_FILE_EXISTS).
E_INVALIDARG	Satu atau beberapa argumen tidak valid.
E_OUTOFMEMORY	Tidak cukup memori yang tersedia untuk menyelesaikan operasi.

Keterangan

Penjadwal tugas menyediakan dua metode untuk menambahkan item kerja: NewWorkItem dan AddWorkItem. Dari metode ini, masing-masing memiliki keuntungan khusus. AddWorkItem mencegah penamaan tabrakan, tetapi juga memerlukan dua operasi penulisan disk per panggilan. Satu operasi tulis dilakukan ketika panggilan ke AddWorkItem membuat objek item kerja kosong pada disk, diikuti oleh operasi tulis lain ketika IPersistFile::Save dipanggil.

NewWorkItem tidak mencegah tabrakan penamaan, tetapi hanya memerlukan satu operasi penulisan disk saat IPersistFile::Save dipanggil. Meskipun NewWorkItem lebih efisien dengan operasi penulisan disk, aplikasi menjalankan risiko membuat aplikasi lain membuat item kerja dengan nama yang sama sebelum panggilan ke IPersistFile::Save dibuat.

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	mstask.h
Pustaka	Mstask.lib
DLL	Mstask.dll
Redistribusi	Internet Explorer 4.0 atau yang lebih baru pada Windows NT 4.0 dan Windows 95

Lihat juga

IScheduledWorkItem

ITaskScheduler

ITaskScheduler::NewWorkItem

Bagikan melalui