PeerGraphEnumNodes, fonction (p2p.h)

Article
03/04/2024

La fonction PeerGraphEnumNodes crée et retourne un handle d’énumération utilisé pour énumérer les nœuds dans un graphique homologue. L’énumération fournit une instantané d’un graphique homologue au moment où une énumération est effectuée. Selon la stratégie d’un graphique homologue et si les nœuds ne publient pas d’informations de présence, une énumération ne retourne pas certains nœuds connectés à un graphique homologue.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumNodes(
  [in]  HGRAPH    hGraph,
  [in]  PCWSTR    pwzPeerId,
  [out] HPEERENUM *phPeerEnum
);

Paramètres

[in] hGraph

Gérer vers un graphique d’homologue.

[in] pwzPeerId

ID d’homologue pour obtenir une énumération de nœud. Spécifiez NULL pour retourner tous les nœuds d’un graphique homologue.

[out] phPeerEnum

Reçoit un handle pour une énumération. Utilisez PeerGraphGetNextItem pour récupérer les informations réelles sur le nœud. Lorsque ce handle n’est pas nécessaire, libérez-le en appelant PeerGraphEndEnumeration.

Valeur retournée

Si un appel de fonction réussit, la valeur de retour est S_OK. Sinon, elle retourne l’une des valeurs suivantes.

Code de retour	Description
E_INVALIDARG	Un paramètre n’est pas valide.
E_OUTOFMEMORY	La mémoire est insuffisante pour effectuer une opération spécifiée.
PEER_E_INVALID_GRAPH	Le handle d’un graphique d’homologue n’est pas valide.
PEER_E_NOT_INITIALIZED	Un graphe homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.
PEER_E_NOT_READY	Un graphe homologue n’est pas complètement synchronisé et les nœuds ne peuvent pas être énumérés.
PEER_E_PRESENCE_DISABLED	Un graphique homologue ne nécessite pas d’informations de présence. Par conséquent, les nœuds ne peuvent pas être énumérés.

Remarques

Si PeerGraphGetNextItem est appelé avec le handle retourné par PeerGraphEnumNodes , PeerGraphGetNextItem retourne les données dans la structure PEER_NODE_INFO .

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 de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge	Aucun pris en charge
Plateforme cible	Windows
En-tête	p2p.h
Bibliothèque	P2PGraph.lib
DLL	P2PGraph.dll

Voir aussi

PEER_NODE_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem

Partager via