Bagikan melalui


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