IEnumWorkItems::Metode berikutnya (mstask.h)

Artikel
03/13/2024

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

Mengambil jumlah tugas berikutnya yang ditentukan dalam urutan enumerasi.

Jika ada lebih sedikit dari jumlah tugas yang diminta yang tersisa dalam urutan, semua elemen yang tersisa akan diambil.

Sintaks

HRESULT Next(
  [in]  ULONG  celt,
  [out] LPWSTR **rgpwszNames,
  [out] ULONG  *pceltFetched
);

Parameter

[in] celt

Jumlah tugas yang akan diambil.

[out] rgpwszNames

Penunjuk ke array pointer (LPWSTR) ke string karakter yang dihentikan null yang berisi nama file tugas yang dikembalikan dari urutan enumerasi. Nama file ini diambil dari folder Tugas Terjadwal dan memiliki ekstensi ".job".

Setelah memproses nama yang dikembalikan dalam rgpwszNames, Anda harus terlebih dahulu membebaskan setiap string karakter dalam array dan kemudian array itu sendiri menggunakan CoTaskMemFree.

[out] pceltFetched

Penunjuk ke jumlah tugas yang dikembalikan dalam rgpwszNames. Jika parameter celt adalah 1, parameter ini mungkin NULL.

Nilai kembali

Mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
S_OK	Jumlah tugas yang diambil sama dengan angka yang diminta.
S_FALSE	Angka yang dikembalikan kurang dari angka yang diminta. (Dengan demikian, tidak ada lagi tugas untuk dijumlahkan.)
E_INVALIDARG	Parameter tidak valid.
E_OUTOFMEMORY	Tidak tersedia cukup memori.

Keterangan

Antarmuka IEnumWorkItems juga menyediakan metode untuk mengatur ulang enumerasi, melewati tugas, dan membuat salinan status enumerasi saat ini.

Contoh

Untuk contoh cara menggunakan Berikutnya untuk menghitung tugas di folder Tugas Terjadwal, lihat Menghitung Contoh Tugas.

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

IEnumWorkItems

IEnumWorkItems::Clone

IEnumWorkItems::Reset

IEnumWorkItems::Skip

Bagikan melalui