Fungsi PeerGraphEnumRecords (p2p.h)

Artikel
03/04/2024

Fungsi PeerGraphEnumRecords membuat dan mengembalikan handel enumerasi yang digunakan untuk menghitung rekaman dari jenis rekaman, pengguna, atau keduanya tertentu. Enumerasi menyediakan rekam jepret rekaman pada saat enumerasi dilakukan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumRecords(
  [in]  HGRAPH     hGraph,
  [in]  const GUID *pRecordType,
  [in]  PCWSTR     pwzPeerId,
  [out] HPEERENUM  *phPeerEnum
);

Parameter

[in] hGraph

Menangani grafik serekan.

[in] pRecordType

Arahkan ke jenis rekaman untuk dijumlahkan. Tentukan NULL untuk menghitung semua jenis rekaman.

[in] pwzPeerId

Penunjuk ke string yang mengidentifikasi pembuat bahwa aplikasi meminta enumerasi. Tentukan NULL untuk menghitung semua rekaman.

[out] phPeerEnum

Menerima handel ke enumerasi. Berikan handel ke semua panggilan ke PeerGraphGetNextItem. Ketika handel tidak diperlukan, bebaskan dengan memanggil PeerGraphEndEnumeration.

Nilai kembali

Jika panggilan fungsi berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, ia mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_INVALID_GRAPH	Handel ke grafik serekan tidak valid.
PEER_E_NOT_INITIALIZED	Grafik harus diinisialisasi dengan panggilan ke PeerGraphStartup sebelum menggunakan fungsi ini.

Keterangan

Jika parameter pRecordType dan pwzPeerId adalah NULL, semua rekaman dikembalikan.

Untuk tugas enumerasi sederhana, gunakan fungsi PeerGraphEnumRecords , karena lebih efisien daripada fungsi PeerGraphSearchRecords . Untuk tugas enumerasi dan pemfilteran yang kompleks seperti pencarian heuristik database, gunakan fungsi PeerGraphSearchRecords .

Saat PeerGraphGetNextItem dipanggil dengan handel yang dikembalikan PeerGraphEnumRecords , PeerGraphGetNextItem mengembalikan data dalam struktur PEER_RECORD .

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untukWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2PGraph.lib
DLL	P2PGraph.dll

Lihat juga

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

PeerGraphSearchRecords

Bagikan melalui