Fungsi PeerGraphGetNextItem (p2p.h)

Artikel
03/13/2024

Fungsi PeerGraphGetNextItem mendapatkan item atau item berikutnya dalam enumerasi yang dibuat oleh panggilan ke fungsi berikut, yang mengembalikan handel enumerasi serekan:

Sintaks

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

Parameter

[in] hPeerEnum

Menangani enumerasi.

[in, out] pCount

Input menentukan jumlah item yang akan diperoleh.

Output menerima jumlah item aktual yang diperoleh.

Catatan Jika pCount adalah output nol (0), akhir enumerasi tercapai.

[out] pppvItems

Menerima array pointer ke item yang diminta. Jumlah pointer yang terkandung dalam array ditentukan oleh nilai output pCount. Data aktual yang dikembalikan tergantung pada jenis enumerasi. Jenis struktur yang dikembalikan adalah sebagai berikut: PEER_CONNECTION_INFO, PEER_NODE_INFO, dan PEER_RECORD

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_NOT_INITIALIZED	Grafik harus diinisialisasi dengan panggilan ke PeerGraphStartup sebelum menggunakan fungsi ini.

Keterangan

Gratis ppvItems dengan memanggil PeerGraphFreeData ketika data tidak lagi diperlukan.

Aplikasi dapat meminta berbagai item untuk diperoleh. Fungsi mengembalikan pCount atau lebih sedikit item.

Contoh

Cuplikan kode berikut menunjukkan kepada Anda cara menggunakan PeerGraphGetNextItem untuk menghitung objek, dan mengakhiri enumerasi setelah Anda selesai memproses enumerasi.

//PeerGraphGetNextItem snippet
    // hPeerEnum is a handle to the enumeration obtained from a successful call to PeerGraphEnumConnections,
    // PeerGraphEnumNodes, PeerGraphEnumRecords, or PeerGraphSearchRecords.
    // Set count equal to the maximum number of items you want returned. To obtain a count of all the items
    // in the enumeration, call PeerGraphGetItemCount.
    // ppRecord is an array of pointers to PEER_RECORD objects.  PEER_CONNECTION_INFO and PEER_NODE_INFO structures
    // are also supported.
    HRESULT hr = PeerGraphGetNextItem(hPeerEnum, &count, (PVOID *)&ppRecord);
    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Free the data obtained by PeerGraphGetNextItem.
        PeerGraphFreeData(ppRecord);
    }

    // If you are done with the enumeration, free the handle to the enumeration.
    PeerGraphEndEnumeration(hPeerEnum);

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