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 |
|---|---|
|
Um dos parâmetros não é válido. |
|
Não há memória suficiente disponível para concluir a operação. |
|
A nuvem não pode ser descoberta exclusivamente, por exemplo, mais de uma nuvem corresponde ao nome fornecido. |
|
A identidade de par especificada em pwzIdentity é inválida. |
|
O convite não é confiável para o par. Ele foi alterado ou contém erros. |
|
A nuvem não pode ser localizada. |
|
O convite não é compatível com a versão atual da Infraestrutura de Pares. |
|
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. |
|
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 |