PeerGraphEnumNodes, fonction (p2p.h)

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