Função PeerGroupPasswordJoin (p2p.h)

A função PeerGroupPasswordJoin prepara um par com um convite e a senha correta para ingressar em um grupo de pares protegido por senha antes de chamar PeerGroupConnect ou PeerGroupConnectByAddress.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPasswordJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzPassword,
  [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 com uma senha é criado quando o par convidativo chama PeerGroupCreatePasswordInvitation. Detalhes específicos sobre esse convite, incluindo a senha definida pelo criador do grupo, podem ser obtidos como uma estrutura de PEER_INVITATION_INFO chamando PeerGroupParseInvitation. Este parâmetro é necessário.

[in] pwzPassword

Ponteiro para uma cadeia de caracteres Unicode terminada em zero que contém a senha necessária para validar e ingressar no grupo de pares. Essa senha deve corresponder à senha especificada no convite. 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.

Retornar valor

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_INVITATION_NOT_TRUSTED	O convite não é confiável para o par. Ele foi alterado ou contém erros.
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.
PEER_S_ALREADY_A_MEMBER	O par local tentou ingressar em um grupo com base em uma senha mais de uma vez.

 

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

No caso de uma distorção de relógio entre os computadores participantes, a função Inicial PeerGroupPasswordJoin ainda pode ter êxito, enquanto a chamada a seguir de PeerGroupConnect pode resultar em uma falha na junção, dependendo da gravidade da distorção.

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

Confira também

PeerGroupConnect

PeerGroupConnectByAddress