PeerGetNextItem, fonction (p2p.h)

Article
03/06/2024

La fonction PeerGetNextItem retourne un nombre spécifique d’éléments d’une énumération d’homologues.

Syntaxe

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

Paramètres

[in] hPeerEnum

Gérez l’énumération d’homologue à partir de laquelle les éléments sont récupérés. Ce handle est généré par une fonction d’énumération d’homologue.

[in, out] pCount

Pointeur vers un entier qui spécifie le nombre d’éléments à récupérer à partir de l’énumération d’homologue. Lorsqu’elle est retournée, elle contient le nombre d’éléments dans ppvItems. Ce paramètre ne peut pas avoir la valeur NULL.

[out] pppvItems

Reçoit un pointeur vers un tableau de pointeurs vers les éléments pCount suivants dans l’énumération homologue. Les données, par exemple, un bloc d’informations d’enregistrement ou de membre, dépendent du type d’énumération d’homologue réel.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	L’un des paramètres n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer une opération spécifiée.

Remarques

La fonction PeerGetNextItem retourne ce qui suit :

Éléments qui sont égaux ou inférieurs à la quantité spécifiée dans pCount.
Liste des éléments inférieurs à la quantité spécifiée lorsque le montant est supérieur au nombre d’éléments disponibles.

Note Par exemple, lorsque la valeur entrante de pCount est 10 et que le reste de l’énumération est de 5 éléments, seuls 5 éléments sont retournés et la valeur pointée par pCount est définie sur 5.

Tous les éléments retournés doivent être libérés en passant un pointeur vers le tableau de pointeurs vers la fonction PeerFreeData .

La fin d’une énumération est indiquée lorsque la fonction retourne avec le paramètre pCount défini sur zéro (0).

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le Pack réseau avancé pourWindows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2P.lib
DLL	P2P.dll