Partager via

PeerGraphGetEventData, fonction (p2p.h)

La fonction PeerGraphGetEventData récupère les événements d’homologue. Une application appelle cette fonction jusqu’à ce que la valeur de retour PEER_S_NO_EVENT_DATA soit retournée, ce qui indique qu’un appel réussit, mais qu’il n’y a plus d’événements homologues à récupérer.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GRAPH_EVENT_DATA *ppEventData
);

Paramètres

[in] hPeerEvent

Handle d’événement d’homologue obtenu par un appel à PeerGraphRegisterEvent.

[out] ppEventData

Reçoit un pointeur vers une structure de PEER_GRAPH_EVENT_DATA qui contient les données relatives à une notification d’événement. Lorsque cette structure n’est pas nécessaire, libérez-la en appelant PeerGraphFreeData.

Valeur retournée

Si l’appel de fonction réussit, la valeur de retour est S_OK. Sinon, il 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_S_NO_EVENT_DATA
 L’appel de fonction réussit, mais aucune donnée n’est associée à un événement d’homologue.
PEER_E_NOT_INITIALIZED
 Un graphe d’homologue doit être initialisé avec un appel à PeerGraphStartup avant d’utiliser cette fonction.

Remarques

Les données d’événement homologue sont retournées dans une structure PEER_GRAPH_EVENT_DATA . Le type de structure de données vers laquelle pointe PEER_GRAPH_EVENT_DATA dépend de l’événement déclenché.

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_GRAPH_EVENT_DATA

PeerGraphFreeData

PeerGraphRegisterEvent

PeerGraphUnregisterEvent

  • Last updated on