Compartilhar via

Função PeerGroupOpen (p2p.h)

  • Artigo

A função PeerGroupOpen abre um grupo de pares que um par criou ou ingressou. Depois que um grupo de pares é aberto, o par pode se registrar para notificações de evento.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parâmetros

[in] pwzIdentity

Ponteiro para uma cadeia de caracteres Unicode que contém a identidade que um par usa para abrir um grupo. Este parâmetro é necessário.

[in] pwzGroupPeerName

Ponteiro para uma cadeia de caracteres Unicode que contém o nome do par do grupo de pares. Este parâmetro é necessário.

[in] pwzCloud

Ponteiro para uma cadeia de caracteres Unicode que contém o nome da nuvem PNRP na qual o grupo de pares está localizado. Se o valor for NULL, a nuvem especificada nas propriedades do grupo de pares será usada.

[out] phGroup

Ponteiro para um identificador para um grupo de pares. Se esse valor for NULL, a operação aberta não será bem-sucedida. 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_CLOUD_NAME_AMBIGUOUS
 A nuvem especificada no pwzCloud não pode ser descoberta exclusivamente, por exemplo, mais de uma nuvem corresponde ao nome fornecido.
PEER_E_NO_CLOUD
 A nuvem especificada no pwzCloud não pode ser localizada.
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

Vários aplicativos podem abrir o mesmo grupo simultaneamente. Qualquer aplicativo pode optar por abrir um grupo sem chamar PeerGroupConnect posteriormente. Esses aplicativos são considerados offline. No entanto, um segundo aplicativo pode abrir e conectar o par ao grupo, o que significa que um aplicativo deve estar pronto para se conectar a qualquer momento.

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

PeerGroupClose

PeerGroupConnect

PeerGroupCreate

PeerGroupJoin