IEnumConnections::Metode berikutnya (ocidl.h)

  • Artikel

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)

Lihat juga

CONNECTDATA

IEnumConnections