Função PeerGroupJoin (p2p.h)

Artigo
08/25/2023

A função PeerGroupJoin prepara um par com um convite para ingressar em um grupo de pares existente antes de chamar PeerGroupConnect ou PeerGroupConnectByAddress.

Sintaxe

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

Parâmetros

[in] pwzIdentity

Ponteiro para uma cadeia de caracteres Unicode que contém a identidade abrindo o grupo de pares especificado. Se esse parâmetro for NULL, a implementação usará a identidade obtida de PeerIdentityGetDefault.

[in] pwzInvitation

Ponteiro para uma cadeia de caracteres Unicode que contém o convite XML concedido por outro par. Um convite é criado quando o par convidativo chama PeerGroupCreateInvitation ou PeerGroupIssueCredentials. Detalhes específicos sobre esse convite podem ser obtidos como uma estrutura PEER_INVITATION_INFO chamando PeerGroupParseInvitation. Este parâmetro é necessário.

[in] pwzCloud

Ponteiro para uma cadeia de caracteres Unicode que contém o nome da nuvem PNRP em que um grupo está localizado. O valor padrão é NULL, que indica que a nuvem especificada no convite deve ser usada.

[out] phGroup

Ponteiro para o identificador do grupo de pares. Para iniciar a comunicação com um grupo, chame PeerGroupConnect. 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 não pode ser descoberta exclusivamente, por exemplo, mais de uma nuvem corresponde ao nome fornecido.
PEER_E_INVALID_PEER_NAME	A identidade de par especificada em pwzIdentity é inválida.
PEER_E_INVALID_TIME_PERIOD	O período de validade especificado no convite é inválido. O período especificado expirou ou o convite ainda não é válido (ou seja, a data\hora do ValidityStart especificada ainda não foi atingida). Um motivo possível para o retorno desse erro é que o relógio do sistema está definido incorretamente no computador que ingressa no grupo ou no computador que emitiu o convite.
PEER_E_INVITATION_NOT_TRUSTED	O convite não é confiável. Isso pode ser devido a alteração de convite, erros ou expiração.
PEER_E_NO_CLOUD	A nuvem não pode ser localizada.
PEER_E_UNSUPPORTED_VERSION	O convite não é compatível com a versão atual da Infraestrutura de Pares.
PEER_E_NO_KEY_ACCESS	O acesso à identidade de par ou às chaves do 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.

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