Função PeerGroupConnect (p2p.h)
A função PeerGroupConnect inicia uma pesquisa PNRP para um grupo de pares e tenta se conectar a ele. Depois que essa função for chamada com êxito, um par poderá se comunicar com outros membros do grupo de pares.
Sintaxe
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
[in] HGROUP hGroup
);
Parâmetros
[in] hGroup
Manipule para o grupo de pares ao qual um par pretende se conectar. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen, PeerGroupJoin ou PeerGroupPasswordJoin . Este parâmetro é necessário.
Retornar valor
Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará o valor a seguir.
| Código de retorno | Descrição |
|---|---|
|
O identificador para o grupo de pares é inválido. |
Erros específicos de criptografia podem ser retornados do Provedor Base do Microsoft RSA. Esses erros são prefixados com CRYPT_* e definidos em Winerror.h.
Comentários
Um aplicativo se registra para eventos pares antes de chamar essa função. Se a chamada de função não for bem-sucedida, um evento PEER_GROUP_EVENT_CONNECTION_FAILED será gerado. Caso contrário, um evento de PEER_GROUP_EVENT_STATUS_CHANGED será gerado.
O evento PEER_GROUP_EVENT_CONNECTION_FAILED também é gerado quando um criador de grupo falha ao chamar PeerGroupConnect imediatamente após a criação. Se isso não ocorrer, os usuários que receberem um convite chamarão PeerGroupConnect com êxito, mas não poderão escutar e, eventualmente, receberão o evento com falha de conexão.
No caso de uma distorção de relógio entre os computadores participantes, o sucesso de PeerGroupConnect pode depender da gravidade da distorção. Ao solucionar uma falha ao ingressar, essa possibilidade deve ser levada em consideração verificando se os relógios do computador estão sincronizados.
Para estar presente no grupo de pares e receber eventos, mas permanecer desconectado, use a função PeerGroupOpen .
Se um valor de tempo limite para PeerGroupConnect não for fornecido no aplicativo, encontrar uma falha fará com que o aplicativo seja travado. É recomendável um valor de tempo limite de 30 segundos.
Antes de chamar PeerGroupConnect, existe um grupo em um 'Estado Desconectado'. Durante esse tempo, o grupo não pode ser detectado ou receber conexões. Para retornar um grupo a esse estado, a função PeerGroupClose deve ser chamada.
Requisitos
| Requisito | Valor |
|---|---|
| Cliente mínimo com suporte | Windows XP com SP2 [somente aplicativos da área de trabalho], Windows XP com SP1 com o Pacote de Rede Avançado paraWindows XP |
| Servidor mínimo com suporte | Nenhum compatível |
| Plataforma de Destino | Windows |
| Cabeçalho | p2p.h |
| Biblioteca | P2P.lib |
| DLL | P2P.dll |