Funzione PeerGroupRegisterEvent (p2p.h)

Articolo
03/05/2024

La funzione PeerGroupRegisterEvent registra un peer per eventi specifici del gruppo di peer.

Sintassi

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

Parametri

[in] hGroup

Handle del gruppo peer in cui monitorare gli eventi peer specifici. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] hEvent

Puntatore a un handle di evento di Windows, che viene segnalato quando viene generato un evento peer. Quando questo handle viene segnalato, il peer deve chiamare PeerGroupGetEventData fino a quando la funzione non restituisce PEER_S_NO_EVENT_DATA. Questo parametro è obbligatorio.

[in] cEventRegistration

Contiene il numero di strutture PEER_GROUP_EVENT_REGISTRATION elencate in pEventRegistrations. Questo parametro è obbligatorio.

[in] pEventRegistrations

Puntatore a un elenco di strutture PEER_GROUP_EVENT_REGISTRATION che contiene i tipi di evento peer per cui si verifica la registrazione. Questo parametro è obbligatorio.

[out] phPeerEvent

Puntatore all'handle HPEEREVENT restituito. Un peer può annullare la registrazione per questo evento peer passando questo handle a PeerGroupUnregisterEvent. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per completare l'operazione.
PEER_E_INVALID_GROUP	L'handle per il gruppo non è valido.

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

Prima di chiudere l'handle HPEEREVENT, è necessario annullare la registrazione per i tipi di evento peer passando l'handle a PeerGroupUnregisterEvent.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll