PeerGroupRegisterEvent, fonction (p2p.h)

Article
03/01/2024

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