IEnumTASK::Metode berikutnya (mmc.h)

Artikel
08/24/2023

Metode IEnumTASK::Next memungkinkan MMC untuk mengambil tugas berikutnya dalam daftar tugas snap-in.

Sintaks

HRESULT Next(
  [in]  ULONG    celt,
  [out] MMC_TASK *rgelt,
  [out] ULONG    *pceltFetched
);

Parameter

[in] celt

Nilai yang menentukan jumlah tugas yang akan disediakan. MMC selalu menghitung tugas satu per satu; oleh karena itu, celt selalu 1.

[out] rgelt

Penunjuk ke struktur MMC_TASK yang diisi snap-in untuk mewakili tugas yang akan ditambahkan ke taskpad. Ketahuilah bahwa pemanggil (MMC) mengalokasikan memori untuk struktur.

[out] pceltFetched

Penunjuk ke nilai yang menentukan jumlah tugas yang dikembalikan. Jika snap-in berhasil mengembalikan satu atau beberapa tugas, atur nilai ke jumlah tugas yang berhasil dikembalikan. Karena MMC selalu meminta satu tugas sekaligus (celt selalu 1), pceltFetched harus diatur ke 1 jika tugas berhasil dikembalikan. Jika snap-in tidak memiliki lagi tugas dalam daftarnya, atau jika snap-in gagal mengisi struktur MMC_TASK, atur nilai ke 0.

Menampilkan nilai

Metode ini dapat mengembalikan salah satu nilai ini.

Keterangan

MMC memanggil metode ini untuk menghitung daftar tugas yang harus ditambahkan snap-in ke taskpad. MMC memanggil metode ini sampai kembali S_FALSE untuk menunjukkan tidak ada lagi tugas untuk snap-in untuk ditambahkan ke taskpad.