Fungsi PeerGetNextItem (p2p.h)

Artikel
03/13/2024

Fungsi PeerGetNextItem mengembalikan jumlah item tertentu dari enumerasi serekan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGetNextItem(
  [in]      HPEERENUM hPeerEnum,
  [in, out] ULONG     *pCount,
  [out]     PVOID     **pppvItems
);

Parameter

[in] hPeerEnum

Tangani enumerasi serekan dari mana item diambil. Handel ini dihasilkan oleh fungsi enumerasi serekan.

[in, out] pCount

Penunjuk ke bilangan bulat yang menentukan jumlah item yang akan diambil dari enumerasi serekan. Saat dikembalikan, item berisi jumlah item dalam ppvItems. Parameter ini tidak boleh NULL.

[out] pppvItems

Menerima penunjuk ke array pointer ke item pCount berikutnya dalam enumerasi serekan. Data, misalnya, blok informasi rekaman atau anggota, tergantung pada jenis enumerasi serekan yang sebenarnya.

Nilai kembali

Mengembalikan S_OK jika operasi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.

Keterangan

Fungsi PeerGetNextItem mengembalikan hal berikut:

Item yang sama dengan atau kurang dari jumlah yang ditentukan dalam pCount.
Daftar item yang kurang dari jumlah yang ditentukan saat jumlahnya lebih besar dari jumlah item yang tersedia.

Catatan Misalnya, ketika nilai masuk pCount adalah 10 dan sisa enumerasi adalah 5 item, hanya 5 item yang dikembalikan dan nilai yang ditujukan oleh pCount diatur ke 5.

Semua item yang dikembalikan harus dikosongkan dengan meneruskan penunjuk ke array pointer ke fungsi PeerFreeData .

Akhir enumerasi ditunjukkan ketika fungsi kembali dengan parameter pCount diatur ke nol (0).

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Advanced Networking Pack forWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2P.lib
DLL	P2P.dll