IEnumConnections::Metode berikutnya (ocidl.h)
Mengambil jumlah item yang ditentukan dalam urutan enumerasi.
Sintaks
HRESULT Next(
[in] ULONG cConnections,
[out] LPCONNECTDATA rgcd,
[out] ULONG *pcFetched
);
Parameter
[in] cConnections
Jumlah item yang akan diambil. Jika ada kurang dari jumlah item yang diminta yang tersisa dalam urutan, metode ini mengambil elemen yang tersisa.
[out] rgcd
Array item yang dijumlahkan.
Enumerator bertanggung jawab untuk mengalokasikan memori apa pun, dan pemanggil bertanggung jawab untuk membebaskannya. 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] pcFetched
Jumlah item yang diambil. Parameter ini selalu kurang dari atau sama dengan jumlah item yang diminta.
Mengembalikan nilai
Jika metode mengambil jumlah item yang diminta, nilai yang dikembalikan S_OK. Jika tidak, itu S_FALSE.
Keterangan
Setelah metode ini berhasil dikembalikan, pemanggil bertanggung jawab untuk memanggil Rilis (lihat anggota pUnkCONNECTDATA) untuk setiap elemen dalam array. Jika cConnections lebih besar dari satu, penelepon juga harus meneruskan penunjuk non-NULL ke lpcFetched untuk mendapatkan jumlah pointer yang harus dilepaskan.
E_NOTIMPL tidak diizinkan sebagai nilai yang dikembalikan. Jika nilai kesalahan dikembalikan, tidak ada entri dalam array yang valid saat keluar, dan oleh karena itu tidak ada rilis yang diperlukan.
Persyaratan
Persyaratan | Nilai |
---|---|
Klien minimum yang didukung | Windows 2000 Professional [aplikasi desktop | Aplikasi UWP] |
Server minimum yang didukung | Windows 2000 Server [aplikasi desktop | Aplikasi UWP] |
Target Platform | Windows |
Header | ocidl.h (termasuk ObjIdl.h) |