Funzione PeerGroupGetEventData (p2p.h)

Articolo
03/15/2023

La funzione PeerGroupGetEventData consente a un'applicazione di recuperare i dati restituiti da un evento di raggruppamento.

Sintassi

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

Parametri

[in] hPeerEvent

Handle ottenuto da una chiamata precedente a PeerGroupRegisterEvent. Questo parametro è obbligatorio.

[out] ppEventData

Puntatore a una struttura PEER_GROUP_EVENT_DATA che contiene dati sull'evento peer. Questa struttura di dati deve essere liberata dopo l'uso con PeerFreeData. 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.
PEER_S_NO_EVENT_DATA	La chiamata ha esito positivo, ma non sono disponibili dati sull'evento.

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

Quando si verifica un evento per il quale un peer ha richiesto una notifica, viene segnalato l'handle di eventi peer corrispondente. Il peer chiama questo metodo fino a quando non vengono recuperate le strutture PEER_GROUP_EVENT_DATA. Ogni struttura di dati contiene le due parti chiave di dati seguenti:

Registrazione associata a un evento peer.
Dati effettivi per un evento peer.

Requisiti


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

Vedi anche

PEER_GROUP_EVENT_DATA

PeerFreeData

PeerGroupRegisterEvent

Condividi tramite