Partager via


PeerGroupRegisterEvent, fonction (p2p.h)

La fonction PeerGroupRegisterEvent inscrit un homologue pour des événements de groupe d’homologues spécifiques.

Syntaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupRegisterEvent(
  [in]  HGROUP                        hGroup,
  [in]  HANDLE                        hEvent,
  [in]  DWORD                         cEventRegistration,
  [in]  PEER_GROUP_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Paramètres

[in] hGroup

Handle du groupe d’homologues sur lequel surveiller les événements homologues spécifiques. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] hEvent

Pointeur vers un handle d’événement Windows, qui est signalé lorsqu’un événement homologue est déclenché. Lorsque ce handle est signalé, l’homologue doit appeler PeerGroupGetEventData jusqu’à ce que la fonction retourne PEER_S_NO_EVENT_DATA. Ce paramètre est obligatoire.

[in] cEventRegistration

Contient le nombre de structures PEER_GROUP_EVENT_REGISTRATIONrépertoriées dans pEventRegistrations. Ce paramètre est obligatoire.

[in] pEventRegistrations

Pointeur vers une liste de structures PEER_GROUP_EVENT_REGISTRATION qui contient les types d’événements homologues pour lesquels l’inscription a lieu. Ce paramètre est obligatoire.

[out] phPeerEvent

Pointeur vers le handle HPEEREVENT retourné. Un homologue peut annuler l’inscription pour cet événement d’homologue en passant ce handle à PeerGroupUnregisterEvent. 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.
E_OUTOFMEMORY
La mémoire disponible est insuffisante pour terminer l’opération.
PEER_E_INVALID_GROUP
Le handle du groupe n’est pas valide.
 

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.

Remarques

Avant de fermer le handle HPEEREVENT, vous devez annuler l’inscription pour les types d’événements homologues en passant le handle à PeerGroupUnregisterEvent.

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

Voir aussi

PEER_GROUP_EVENT_DATA

PEER_GROUP_EVENT_REGISTRATION

PeerGroupCreate

PeerGroupGetEventData

PeerGroupJoin

PeerGroupOpen

PeerGroupUnregisterEvent