IEnumOleUndoUnits::Metode berikutnya (ocidl.h)
Mengambil jumlah item yang ditentukan dalam urutan enumerasi.
Sintaks
HRESULT Next(
[in] ULONG cElt,
[out] IOleUndoUnit **rgElt,
[out] ULONG *pcEltFetched
);
Parameter
[in] cElt
Jumlah item yang akan diambil. Jika ada kurang dari jumlah item yang diminta yang tersisa dalam urutan, metode ini mengambil elemen yang tersisa.
[out] rgElt
Array item yang dijumlahkan.
Enumerator bertanggung jawab untuk memanggil AddRef, dan pemanggil bertanggung jawab untuk memanggil Rilis melalui setiap pointer yang dijumlahkan. Jika cElt lebih besar dari 1, penelepon juga harus meneruskan pointer non-NULL yang diteruskan ke pcEltFetched untuk mengetahui berapa banyak pointer yang akan dilepaskan.
[out] pcEltFetched
Jumlah item yang diambil. Parameter ini selalu kurang dari atau sama dengan jumlah item yang diminta.
Nilai kembali
Jika metode mengambil jumlah item yang diminta, nilai yang dikembalikan S_OK. Jika tidak, itu S_FALSE.
Keterangan
Pemanggil bertanggung jawab untuk memanggil metode Rilis untuk setiap elemen dalam array setelah metode ini berhasil dikembalikan. Jika cUndoUnits lebih besar dari satu, penelepon juga harus meneruskan penunjuk non-NULL ke pcFetched untuk mendapatkan jumlah pointer yang harus dilepaskan.
E_NOTIMPL tidak diizinkan sebagai nilai yang dikembalikan. Jika nilai kesalahan dikembalikan, tidak ada entri dalam array rgpcd yang valid saat keluar dan tidak memerlukan rilis.
Persyaratan
| Klien minimum yang didukung | Windows 2000 Professional [hanya aplikasi desktop] |
| Server minimum yang didukung | Windows 2000 Server [hanya aplikasi desktop] |
| Target Platform | Windows |
| Header | ocidl.h |