Partager via


PeerGraphGetNodeInfo, fonction (p2p.h)

La fonction PeerGraphGetNodeInfo récupère des informations sur un nœud spécifique.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetNodeInfo(
  [in]  HGRAPH          hGraph,
  [in]  ULONGLONG       ullNodeId,
  [out] PPEER_NODE_INFO *ppNodeInfo
);

Paramètres

[in] hGraph

Gérer vers un graphe d’homologue.

[in] ullNodeId

Spécifie l’ID d’un nœud sur lequel une application reçoit des informations. Spécifiez zéro (0) pour récupérer des informations sur le nœud local.

[out] ppNodeInfo

Reçoit un pointeur vers une structure PEER_NODE_INFO qui contient les informations demandées. Lorsque le handle n’est pas nécessaire, libérez-le en appelant PeerGraphFreeData.

Valeur retournée

Si la fonction réussit, la valeur de retour est S_OK. Sinon, la fonction retourne l’un des codes d’erreur suivants.

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 graphe d’homologue n’est pas valide.
PEER_E_NOT_INITIALIZED
Un graphe d’homologue doit être initialisé à l’aide d’un appel à PeerGraphStartup avant d’utiliser cette fonction.
PEER_E_NODE_NOT_FOUND
Un nœud spécifié est introuvable.

Remarques

Il peut y avoir plusieurs nœuds d’un graphe sur un ordinateur. Par exemple, plusieurs utilisateurs peuvent avoir joint le graphe sur un ordinateur spécifique, de sorte que les informations que PeerGraphGetNodeInfo retourne concernent chaque nœud, et non chaque ordinateur.

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

Voir aussi

PEER_NODE_INFO

PeerGraphFreeData