Compartilhar via


Função PeerGroupConnectByAddress (p2p.h)

A função PeerGroupConnectByAddress tenta se conectar ao grupo de pares do qual outros pares com endereços IPv6 conhecidos estão participando. Depois que essa função for chamada com êxito, um par poderá se comunicar com outros membros do grupo par.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnectByAddress(
  [in] HGROUP        hGroup,
  [in] ULONG         cAddresses,
  [in] PPEER_ADDRESS pAddresses
);

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.

[in] cAddresses

O número total de estruturas de PEER_ADDRESSapontadas por pAddresses.

[in] pAddresses

Ponteiro para uma lista de estruturas de PEER_ADDRESS que especificam os pontos de extremidade dos pares que participam do grupo.

Valor retornado

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

Se um valor de tempo limite para PeerGroupConnectByAddress não for fornecido no aplicativo, encontrar uma falha fará com que o aplicativo seja travado. Um valor de tempo limite de 30 segundos é recomendado.

Requisitos

   
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

Confira também

PEER_ADDRESS

PeerGroupConnect

PeerGroupJoin

PeerGroupPasswordJoin