Función PeerCollabRegisterEvent (p2p.h)

La función PeerCollabRegisterEvent registra una aplicación con la infraestructura de colaboración del mismo nivel para recibir devoluciones de llamada para eventos de colaboración del mismo nivel específicos.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCollabRegisterEvent(
  [in]  HANDLE                         hEvent,
  [in]  DWORD                          cEventRegistration,
  [in]  PEER_COLLAB_EVENT_REGISTRATION *pEventRegistrations,
  [out] HPEEREVENT                     *phPeerEvent
);

Parámetros

[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 PeerCollabGetEventData para recuperar eventos hasta que se devuelva PEER_S_NO_EVENT_DATA.

[in] cEventRegistration

Número de estructuras de PEER_COLLAB_EVENT_REGISTRATION en pEventRegistrations.

[in] pEventRegistrations

Matriz de estructuras de PEER_COLLAB_EVENT_REGISTRATION que especifican los eventos de colaboración del mismo nivel para los que la aplicación solicita la notificación.

[out] phPeerEvent

Identificador de eventos del mismo nivel devuelto por esta función. Este identificador se pasa a PeerCollabGetEventData cuando se genera un evento de red de colaboración del mismo nivel en el mismo nivel.

Valor devuelto

Devuelve S_OK si la función se realiza correctamente. De lo contrario, la función devuelve uno de los valores siguientes.

Código devuelto	Descripción
E_OUTOFMEMORY	No hay suficiente memoria para admitir esta operación.
E_INVALIDARG	Uno de los argumentos no es válido.
PEER_E_SERVICE_NOT_AVAILABLE	Se intentó llamar a PeerCollabRegisterEvent desde un proceso con privilegios elevados.
PEER_E_NOT_INITIALIZED	La infraestructura del mismo nivel de Windows no se inicializa. Se requiere llamar a la función de inicialización pertinente.

Comentarios

Si el servicio p2phost.exe no se está ejecutando, esta función intentará iniciarla para los registros que requieren p2phost.

Si se intenta iniciar p2phost.exe desde un proceso con privilegios elevados, se devuelve un error. Como resultado, una aplicación no puede poner en peligro la seguridad concediéndole privilegios administrativos por error a p2phost.exe. No es posible iniciar p2phost.exe en un modo no interactivo, ya que necesita mostrar cuadros de diálogo de Windows para las invitaciones entrantes.

Cuando se llama a PeerCollabRegisterEvent en las máquinas con mucha tensión, la función puede devolver el código de error PEER_E_SERVICE_NOT_AVAILABLE.

Una aplicación puede llamar a PeerCollabRegisterEvent varias veces, donde cada llamada se considera un registro independiente. Cuando un evento se registra varias veces, cada registro recibe una copia del evento.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible	No se admite ninguno
Plataforma de destino	Windows
Encabezado	p2p.h
Library	P2P.lib
Archivo DLL	P2P.dll

Consulte también

PEER_COLLAB_EVENT_REGISTRATION

Funciones de API de colaboración del mismo nivel

PeerCollabGetEventData