Fungsi PeerGraphEnumNodes (p2p.h)

Artikel
03/01/2024

Fungsi PeerGraphEnumNodes membuat dan mengembalikan handel enumerasi yang digunakan untuk menghitung simpul dalam grafik serekan. Enumerasi menyediakan rekam jepret grafik serekan pada saat enumerasi dilakukan. Bergantung pada kebijakan grafik serekan, dan jika simpul tidak menerbitkan informasi kehadiran, enumerasi tidak mengembalikan beberapa simpul yang terhubung ke grafik serekan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

Parameter

[in] hGraph

Menangani ke grafik serekan.

[in] pwzPeerId

ID peer untuk mendapatkan enumerasi simpul. Tentukan NULL untuk mengembalikan semua simpul dalam grafik serekan.

[out] phPeerEnum

Menerima handel ke enumerasi. Gunakan PeerGraphGetNextItem untuk mengambil informasi simpul yang sebenarnya. Ketika handel ini 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 peer tidak valid.
PEER_E_NOT_INITIALIZED	Grafik serekan harus diinisialisasi dengan panggilan ke PeerGraphStartup sebelum menggunakan fungsi ini.
PEER_E_NOT_READY	Grafik serekan tidak disinkronkan sepenuhnya, dan simpul tidak dapat dijumlahkan.
PEER_E_PRESENCE_DISABLED	Grafik serekan tidak memerlukan informasi kehadiran. Oleh karena itu, simpul tidak dapat dijumlahkan.

Keterangan

Jika PeerGraphGetNextItem dipanggil dengan handel yang dikembalikan PeerGraphEnumNodes , maka PeerGraphGetNextItem mengembalikan data dalam struktur PEER_NODE_INFO .

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	P2PGraph.lib
DLL	P2PGraph.dll

Lihat juga

PEER_NODE_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

Bagikan melalui