Partager via


PeerGraphEnumConnections, fonction (p2p.h)

La fonction PeerGraphEnumConnections crée et retourne un handle d’énumération utilisé pour énumérer les connexions d’un nœud local.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphEnumConnections(
  [in]  HGRAPH    hGraph,
  [in]  DWORD     dwFlags,
  [out] HPEERENUM *phPeerEnum
);

Paramètres

[in] hGraph

Gérer vers un graphique d’homologue.

[in] dwFlags

Type de connexion à énumérer. Ce paramètre est obligatoire. Les valeurs valides sont spécifiées par PEER_CONNECTION_FLAGS.

[out] phPeerEnum

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

Valeur retournée

Si l’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
L’un des paramètres 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
Le graphe homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Lorsque PeerGraphGetNextItem est appelé avec le handle d’énumération retourné par PeerGraphEnumConnections, PeerGraphGetNextItem renvoie une structure PEER_CONNECTION_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_CONNECTION_INFO

PeerGraphEndEnumeration

PeerGraphGetItemCount

PeerGraphGetNextItem