Condividi tramite


Funzione PeerGraphRegisterEvent (p2p.h)

La funzione PeerGraphRegisterEvent registra la richiesta di un peer per ricevere una notifica delle modifiche associate a un grafico peer e al tipo di evento.

Sintassi

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphRegisterEvent(
  [in]  HGRAPH                        hGraph,
  [in]  HANDLE                        hEvent,
  [in]  ULONG                         cEventRegistrations,
  [in]  PEER_GRAPH_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                    *phPeerEvent
);

Parametri

[in] hGraph

Handle per il grafico peer.

[in] hEvent

Gestire creato da CreateEvent che l'applicazione viene segnalata quando viene attivato un evento. Quando viene segnalato un'applicazione, deve chiamare PeerGraphGetEventData per recuperare gli eventi fino a quando non PEER_S_NO_EVENT_DATA restituito.

[in] cEventRegistrations

Specifica il numero di strutture PEER_GRAPH_EVENT_REGISTRATION in pEventRegistrations.

[in] pEventRegistrations

Punta a una matrice di strutture PEER_GRAPH_EVENT_REGISTRATION che specificano gli eventi per cui l'applicazione richiede notifiche.

[out] phPeerEvent

Riceve un handle HPEEREVENT . Questo handle deve essere usato quando si chiama PeerGraphUnregisterEvent per interrompere la ricezione delle notifiche.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito viene S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito Descrizione
E_INVALIDARG
Uno dei parametri non è valido.
E_OUTOFMEMORY
Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_INVALID_GRAPH
L'handle per il grafico peer non è valido.
PEER_E_NOT_INITIALIZED
Il grafo peer deve essere inizializzato con una chiamata a PeerGraphStartup prima di usare questa funzione.

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

Vedi anche

PEER_GRAPH_EVENT_REGISTRATION

PeerGraphGetEventData

PeerGraphUnregisterEvent