Fungsi PeerGraphGetNextItem (p2p.h)

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

• PeerGraphEnumConnections
• PeerGraphEnumNodes
• PeerGraphEnumRecords
• PeerGraphSearchRecords

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.

[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.

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

Lihat juga

PEER_CONNECTION_INFO

PEER_NODE_INFO

PEER_RECORD

PeerGraphEndEnumeration

PeerGraphEnumConnections

PeerGraphEnumNodes

PeerGraphEnumRecords

PeerGraphFreeData

PeerGraphSearchRecords