Funzione PeerGraphGetNextItem (p2p.h)

Articolo
03/15/2023

La funzione PeerGraphGetNextItem ottiene l'elemento o gli elementi successivi in un'enumerazione creata da una chiamata alle funzioni seguenti, che restituiscono un handle di enumerazione peer:

Sintassi

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

Parametri

[in] hPeerEnum

Handle per un'enumerazione.

[in, out] pCount

Input specifica il numero di elementi da ottenere.

L'output riceve il numero effettivo di elementi ottenuti.

Nota Se pCount è un output zero (0), viene raggiunta la fine dell'enumerazione.

[out] pppvItems

Riceve una matrice di puntatori agli elementi richiesti. Il numero di puntatori contenuti in una matrice viene specificato dal valore di output di pCount. I dati effettivi restituiti dipendono dal tipo di enumerazione. I tipi di strutture restituite sono i seguenti: PEER_CONNECTION_INFO, PEER_NODE_INFO e PEER_RECORD

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito viene S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Un parametro non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire un'operazione specificata.
PEER_E_NOT_INITIALIZED	Il grafico deve essere inizializzato con una chiamata a PeerGraphStartup prima di usare questa funzione.

Commenti

PpvItem gratuiti chiamando PeerGraphFreeData quando i dati non sono più necessari.

L'applicazione può richiedere un intervallo di elementi da ottenere. La funzione restituisce pCount o meno elementi.

Esempio

Il frammento di codice seguente illustra come usare PeerGraphGetNextItem per enumerare gli oggetti e terminare un'enumerazione dopo aver completato l'elaborazione dell'enumerazione.

//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);

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2PGraph.lib
DLL	P2PGraph.dll