Bagikan melalui


IEnumShellItems::Metode berikutnya (shobjidl_core.h)

Mendapatkan array dari satu atau beberapa antarmuka IShellItem dari enumerasi.

Sintaks

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

Parameter

[in] celt

Jenis: ULONG

Jumlah elemen dalam array yang dirujuk oleh parameter rgelt .

[out] rgelt

Jenis: IShellItem**

Alamat array pointer ke antarmuka IShellItem yang menerima item atau item yang dijumlahkan. Aplikasi panggilan bertanggung jawab untuk membebaskan antarmuka IShellItem dengan memanggil metode IUnknown::Release .

[out] pceltFetched

Jenis: ULONG*

Pointer ke nilai yang menerima jumlah antarmuka IShellItem yang berhasil diambil. Jumlahnya bisa lebih kecil dari nilai yang ditentukan dalam parameter celt . Parameter ini dapat berupa NULL pada entri hanya jika celt adalah satu, karena dalam hal ini metode hanya dapat mengambil satu item dan mengembalikan S_OK, atau nol item dan mengembalikan S_FALSE.

Mengembalikan nilai

Jenis: HRESULT

Metode ini dapat mengembalikan salah satu nilai ini.

Menampilkan kode Deskripsi
S_OK
jika setidaknya antarmuka IShellItem diambil.
S_FALSE
jika tidak ada lagi antarmuka IShellItem dalam enumerasi.
Mengembalikan nilai kesalahan jika fungsi gagal karena alasan lain.

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)

Lihat juga

IEnumShellItems

IShellItem