Funzione PeerGetNextItem (p2p.h)

Articolo
03/05/2024

La funzione PeerGetNextItem restituisce un numero specifico di elementi da un'enumerazione peer.

Sintassi

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

Parametri

[in] hPeerEnum

Gestire l'enumerazione peer da cui vengono recuperati gli elementi. Questo handle viene generato da una funzione di enumerazione peer.

[in, out] pCount

Puntatore a un intero che specifica il numero di elementi da recuperare dall'enumerazione peer. Quando restituito, contiene il numero di elementi in ppvItems. Questo parametro non può essere NULL.

[out] pppvItems

Riceve un puntatore a una matrice di puntatori agli elementi pCount successivi nell'enumerazione peer. I dati, ad esempio, un blocco di informazioni su record o membro, dipendono dal tipo di enumerazione peer effettivo.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire un'operazione specificata.

Commenti

La funzione PeerGetNextItem restituisce quanto segue:

Elementi uguali o minori dell'importo specificato in pCount.
Elenco di elementi meno dell'importo specificato quando l'importo è maggiore del numero di elementi disponibili.

Nota Ad esempio, quando il valore in ingresso di pCount è 10 e il resto dell'enumerazione è 5 elementi, vengono restituiti solo 5 elementi e il valore puntato da pCount è impostato su 5.

Tutti gli elementi restituiti devono essere liberati passando un puntatore alla matrice di puntatori alla funzione PeerFreeData .

La fine di un'enumerazione è indicata quando la funzione restituisce con il parametro pCount impostato su zero (0).

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