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 |
|---|---|
|
Un paramètre n’est pas valide. |
|
La mémoire est insuffisante pour effectuer une opération spécifiée. |
|
L’appel de fonction réussit, mais aucune donnée n’est associée à un événement d’homologue. |
|
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 |