Função PeerGroupOpenDirectConnection (p2p.h)

Artigo
08/25/2023

A função PeerGroupOpenDirectConnection estabelece uma conexão direta com outro par em um grupo de pares.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpenDirectConnection(
  [in]  HGROUP        hGroup,
  [in]  PCWSTR        pwzIdentity,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Parâmetros

[in] hGroup

Manipule para o grupo de pares que hospeda a conexão direta. Esse identificador é retornado pela função PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Este parâmetro é necessário.

[in] pwzIdentity

Ponteiro para uma cadeia de caracteres Unicode que contém a identidade à qual um par se conecta. Este parâmetro é necessário.

[in] pAddress

Ponteiro para uma estrutura PEER_ADDRESS que contém o endereço IPv6 ao qual o par se conecta. Este parâmetro é necessário.

[out] pullConnectionId

Inteiro de 64 bits sem sinal que identifica a conexão direta. Esse valor de ID não pode ser considerado válido até que o evento PEER_GROUP_EVENT_DIRECT_CONNECTION seja gerado e indique que a conexão foi aceita pelo outro par. Este parâmetro é necessário.

Valor retornado

Retorna S_OK se a operação for bem-sucedida. Caso contrário, a função retornará um dos valores a seguir.

Código de retorno	Descrição
E_INVALIDARG	Um dos parâmetros não é válido.
E_OUTOFMEMORY	Não há memória suficiente disponível para concluir a operação.
PEER_E_CONNECT_SELF	A conexão falhou porque era um loopback, ou seja, a conexão é entre um par e ele mesmo.
PEER_E_NO_KEY_ACCESS	O acesso à identidade de par ou às chaves de grupo de pares é negado. Normalmente, isso é causado por uma ACL (lista de controle de acesso) incorreta para a pasta que contém as chaves do usuário ou do computador. Isso pode acontecer quando a ACL foi redefinida manualmente.

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

Cada conexão direta aberta com essa função deve ser fechada com PEER_GROUP_EVENT estrutura DATA tem o membro status de seu componente PEER_EVENT_CONNECTION_CHANGE_DATA estrutura definida como PEER_CONNECTION_FAILED.

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