Compartilhar via

Função PeerIdentityExport (p2p.h)

  • Artigo

A função PeerIdentityExport permite que um usuário exporte uma identidade de par. Em seguida, o usuário pode transferir a identidade de par para um computador diferente.

Sintaxe

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityExport(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzPassword,
  [out] PWSTR  *ppwzExportXML
);

Parâmetros

[in] pwzIdentity

Especifica a identidade de par a ser exportada. Esse parâmetro é necessário e não tem um valor padrão.

[in] pwzPassword

Especifica a senha a ser usada para criptografar a identidade do par. Esse parâmetro não pode ser NULL. Essa senha também deve ser usada para importar a identidade de par ou a operação de importação falha.

[out] ppwzExportXML

Recebe um ponteiro para a identidade de par exportada no formato XML. Se a operação de exportação for bem-sucedida, o aplicativo deverá liberar ppwzExportXML 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.
E_OUTOFMEMORY
 Não há memória suficiente para executar a operação especificada.
PEER_E_NO_KEY_ACCESS
 O acesso à identidade de par ou às chaves do grupo de pares foi 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_E_NOT_FOUND
A identidade de par especificada não existe.

Comentários

As credenciais de associação de grupo ponto a ponto não são exportadas. Apenas uma identidade de par é exportada. Uma identidade de par exportada pode ser importada em outro computador usando PeerIdentityImport.

Exportar uma identidade de par não a remove de um ccmputer local, ela faz uma cópia dela. A cópia pode ser usada para fazer backup e restaurar uma identidade de par.

O fragmento XML usado por PeerIdentityExport é o seguinte:

<PEERIDENTITYEXPORT VERSION="1.0">
   <PEERNAME>
     <!-- UTF-8 encoded peer name of the identity -->
   </PEERNAME>
   <DATA xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64">
      <!-- base64 encoded / PFX encoded and encrypted IDC with the private key -->
   </DATA>
</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

PeerIdentityImport