Compartilhar via

Função PeerIdentityImport (p2p.h)

  • Artigo

A função PeerIdentityImport importa uma identidade de par. Se a identidade de par existir em um computador, PEER_E_ALREADY_EXISTS será retornado.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityImport(
  [in]  PCWSTR pwzImportXML,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzIdentity
);

Parâmetros

[in] pwzImportXML

Ponteiro para a identidade de par de formato XML a ser importada, que é retornada por PeerIdentityExport. Esses dados binários devem corresponder ao byte de dados exportados para byte. O XML deve permanecer XML válido sem caracteres extras.

[in] pwzPassword

Especifica a senha a ser usada para desativar a criptografia de uma identidade de par. A senha deve ser idêntica à senha fornecida para PeerIdentityExport. Esse parâmetro não pode ser NULL.

[out] ppwzIdentity

Ponteiro para uma cadeia de caracteres que representa uma identidade de par importada. Se a operação de importação for bem-sucedida, o aplicativo deverá liberar ppwzIdentity chamando PeerFreeData.

Retornar valor

Se a chamada de função for bem-sucedida, o valor retornado será S_OK. Caso contrário, ele retornará um dos valores a seguir.

Código de retorno Descrição
E_INVALIDARG
 Um dos parâmetros não é válido ou os dados XML em ppwzImportXML foram adulterados.
E_OUTOFMEMORY
 Não há memória suficiente para executar a operação especificada.
PEER_E_ALREADY_EXISTS
 A identidade de par já existe neste computador.
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.

Comentários

O fragmento XML usado por PeerIdentityImport é o seguinte:

<PEERIDENTITYEXPORT VERSION="1.0">
   <IDENTITY>
     <!-- UTF-8 encoded peer name of the identity -->
   </IDENTITY>
   <IDENTITYDATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </IDENTTYDATA>
</PEERIDENTITYEXPORT>

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 para Windows 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

PEER_DATA

PeerFreeData

PeerIdentityExport