Partager via


PeerGroupGetEventData, fonction (p2p.h)

La fonction PeerGroupGetEventData permet à une application de récupérer les données retournées par un événement de regroupement.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupGetEventData(
  [in]  HPEEREVENT             hPeerEvent,
  [out] PPEER_GROUP_EVENT_DATA *ppEventData
);

Paramètres

[in] hPeerEvent

Handle obtenu à partir d’un appel précédent à PeerGroupRegisterEvent. Ce paramètre est obligatoire.

[out] ppEventData

Pointeur vers une structure PEER_GROUP_EVENT_DATA qui contient des données sur l’événement homologue. Cette structure de données doit être libérée après utilisation avec PeerFreeData. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour Description
E_INVALIDARG
L’un des paramètres n’est pas valide.
PEER_S_NO_EVENT_DATA
L’appel a réussi, mais aucune donnée d’événement n’est disponible.
 

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Notes

Lorsqu’un événement se produit pour lequel un homologue a demandé une notification, le handle d’événement homologue correspondant est signalé. L’homologue appelle cette méthode jusqu’à ce que PEER_GROUP_EVENT_DATA structures soient récupérées. Chaque structure de données contient les deux éléments clés suivants :

  • Inscription associée à un événement homologue.
  • Données réelles d’un événement homologue.

Spécifications

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

Voir aussi

PEER_GROUP_EVENT_DATA

PeerFreeData

PeerGroupRegisterEvent