IEnumFullIDList::Metode berikutnya (shobjidl_core.h)

Mengambil jumlah item IDLIST_ABSOLUTE yang ditentukan.

Sintaks

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

Parameter

[in] celt

Jenis: ULONG

Jumlah item yang dirujuk dalam array yang dirujuk oleh parameter rgelt .

[out] rgelt

Jenis: PIDLIST_ABSOLUTE*

Jika berhasil, berisi array PIDL. Implementasi harus mengalokasikan pengidentifikasi item ini menggunakan CoTaskMemAlloc. Aplikasi panggilan bertanggung jawab untuk membebaskan pengidentifikasi item menggunakan CoTaskMemFree.

[out] pceltFetched

Jenis: ULONG*

Jika berhasil, berisi pointer ke nilai yang menerima hitungan pengidentifikasi item absolut yang benar-benar dikembalikan dalam rgelt. Jumlahnya bisa lebih kecil dari nilai yang ditentukan dalam parameter celt . Parameter ini dapat berupa NULL pada entri hanya jika celt adalah 1, karena dalam hal ini metode hanya dapat mengambil satu item (S_OK) atau nol (S_FALSE).

Nilai kembali

Jenis: HRESULT

Mengembalikan S_OK jika metode berhasil mengambil elemen celt yang diminta. Metode ini hanya mengembalikan S_OK jika jumlah lengkap item yang diminta berhasil diambil.

S_FALSE menunjukkan bahwa lebih banyak item yang diminta daripada yang tersisa dalam enumerasi. Nilai yang ditujukkan oleh parameter pceltFetched menentukan jumlah aktual item yang diambil. Perhatikan bahwa nilainya akan menjadi 0 jika tidak ada lagi item yang dapat diambil.

Mengembalikan nilai kesalahan yang ditentukan COM jika tidak.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows Vista [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2008 [hanya aplikasi desktop]
Target Platform	Windows
Header	shobjidl_core.h (termasuk Shobjidl.h)