Función PeerGraphRegisterEvent (p2p.h)

La función PeerGraphRegisterEvent registra la solicitud de un mismo nivel para recibir una notificación de los cambios asociados a un grafo del mismo nivel y un tipo de evento.

Sintaxis

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

Parámetros

[in] hGraph

Identificador del gráfico del mismo nivel.

[in] hEvent

Identificador creado por CreateEvent en el que se señala a la aplicación cuando se desencadena un evento. Cuando se señala una aplicación, debe llamar a PeerGraphGetEventData para recuperar eventos hasta que se devuelva PEER_S_NO_EVENT_DATA.

[in] cEventRegistrations

Especifica el número de estructuras de PEER_GRAPH_EVENT_REGISTRATION en pEventRegistrations.

[in] pEventRegistrations

Apunta a una matriz de estructuras de PEER_GRAPH_EVENT_REGISTRATION que especifican los eventos a los que la aplicación solicita notificaciones.

[out] phPeerEvent

Recibe un controlador HPEEREVENT . Este identificador se debe usar al llamar a PeerGraphUnregisterEvent para dejar de recibir notificaciones.

Valor devuelto

Si la llamada de función se realiza correctamente, el valor devuelto es S_OK. De lo contrario, devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_INVALIDARG	Uno de los parámetros no es válido.
E_OUTOFMEMORY	No hay suficiente memoria para realizar la operación especificada.
PEER_E_INVALID_GRAPH	El identificador del grafo del mismo nivel no es válido.
PEER_E_NOT_INITIALIZED	El grafo del mismo nivel debe inicializarse con una llamada a PeerGraphStartup antes de usar esta función.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows XP con SP2 [solo aplicaciones de escritorio],Windows XP con SP1 con advanced Networking Pack forWindows XP
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2PGraph.lib
Archivo DLL	P2PGraph.dll

Consulte también

PEER_GRAPH_EVENT_REGISTRATION

PeerGraphGetEventData

PeerGraphUnregisterEvent