ITaskScheduler::Metode NewWorkItem (mstask.h)

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

Metode NewWorkItem membuat item kerja baru, mengalokasikan ruang untuk item kerja dan mengambil alamatnya.

Sintaks

HRESULT NewWorkItem(
  [in]  LPCWSTR  pwszTaskName,
  [in]  REFCLSID rclsid,
  [in]  REFIID   riid,
  [out] IUnknown **ppUnk
);

Parameter

[in] pwszTaskName

String yang dihentikan null yang menentukan nama item kerja baru. Nama ini harus sesuai dengan konvensi penamaan file Windows NT, tetapi tidak dapat menyertakan garis miring terbelakang karena bersarang dalam objek folder tugas tidak diizinkan.

[in] rclsid

Pengidentifikasi kelas item kerja yang akan dibuat. Satu-satunya kelas yang didukung saat ini, kelas tugas, memiliki pengidentifikasi CLSID_Ctask.

[in] riid

Pengidentifikasi referensi antarmuka yang diminta. Satu-satunya antarmuka yang didukung saat ini, ITask, memiliki pengidentifikasi IID_ITask.

[out] ppUnk

Penunjuk ke penunjuk antarmuka yang menerima antarmuka yang diminta. Lihat Keterangan untuk informasi tentang menyimpan item kerja ke disk.

Nilai kembali

Metode NewWorkItem mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Operasi berhasil.
ERROR_FILE_EXISTS	Item kerja 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.
E_ACCESSDENIED	Pemanggil tidak memiliki izin untuk melakukan operasi. Untuk informasi selengkapnya, lihat Item Kerja Terjadwal.

Keterangan

Metode ini menangani alokasi memori secara otomatis saat membuat item kerja baru.

Untuk menyimpan item kerja ke disk, panggil IPersistFile::Save . Antarmuka COM ini didukung oleh semua antarmuka item kerja (saat ini ITask adalah satu-satunya antarmuka item kerja yang didukung).

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.

Anda dapat membuat tugas dengan memanggil AddWorkItem atau NewWorkItem. Saat menggunakan AddWorkItem, Anda bertanggung jawab untuk membuat instans objek Tugas (yang mendukung antarmuka ITask ) lalu menambahkan tugas dengan nama yang Anda berikan.

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

Untuk contoh lengkap	Lihat
Membuat tugas baru	Membuat Tugas Menggunakan Contoh NewWorkItem

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

IPersistFile::Simpan

ITask

ITaskScheduler

ITaskScheduler::AddWorkItem