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 |
|---|---|
|
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 |