Función PeerGroupConnect (p2p.h)

La función PeerGroupConnect inicia una búsqueda PNRP de un grupo del mismo nivel e intenta conectarse a él. Una vez que se llama correctamente a esta función, un elemento del mismo nivel puede comunicarse con otros miembros del grupo del mismo nivel.

Sintaxis

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
  [in] HGROUP hGroup
);

Parámetros

[in] hGroup

Identificador del grupo del mismo nivel al que un elemento del mismo nivel pretende conectarse. El identificador lo devuelve la función PeerGroupCreate, PeerGroupOpen,PeerGroupJoin o PeerGroupPasswordJoin. Este parámetro es obligatorio.

Valor devuelto

Devuelve S_OK si la operación se realiza correctamente. De lo contrario, la función devuelve el valor siguiente.

Código devuelto	Descripción
PEER_E_INVALID_GROUP	El identificador del grupo del mismo nivel no es válido.

 

Los errores específicos de criptografía se pueden devolver desde el proveedor base RSA de Microsoft. Estos errores tienen el prefijo CRYPT_* y se definen en Winerror.h.

Comentarios

Una aplicación se registra para eventos del mismo nivel antes de llamar a esta función. Si la llamada de función no se realiza correctamente, se genera un evento de PEER_GROUP_EVENT_CONNECTION_FAILED. De lo contrario, se genera un evento de PEER_GROUP_EVENT_STATUS_CHANGED.

El evento PEER_GROUP_EVENT_CONNECTION_FAILED también se genera cuando un creador de grupos no puede llamar a PeerGroupConnect inmediatamente después de la creación. Si esto no tiene lugar, los usuarios con una invitación llamarán a PeerGroupConnect correctamente, pero no podrán escuchar y finalmente recibirán el evento de error de conexión.

En caso de asimetría de reloj entre las máquinas participantes, el éxito de PeerGroupConnect puede depender de la gravedad del sesgo. Al solucionar un error al unirse, debe tenerse en cuenta esta posibilidad comprobando que los relojes de la máquina están sincronizados.

Para estar presente en el grupo del mismo nivel y recibir eventos, pero permanecen sin conexión, use la función PeerGroupOpen .

Si no se proporciona un valor de tiempo de espera para PeerGroupConnect en la aplicación, si se produce un error, la aplicación se bloqueará. Se recomienda un valor de tiempo de espera de 30 segundos.

Antes de llamar a PeerGroupConnect, existe un grupo en un "Estado desconectado". Durante este tiempo, el grupo no se puede detectar ni recibir conexiones. Para devolver un grupo a este estado, se debe llamar a la función PeerGroupClose .

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

Consulte también

PeerGroupClose

PeerGroupJoin

PeerGroupOpen

PeerGroupPasswordJoin