Funzione PeerIdentityExport (p2p.h)

Articolo
03/01/2024

La funzione PeerIdentityExport consente a un utente di esportare un'identità peer. L'utente può quindi trasferire l'identità peer in un computer diverso.

Sintassi

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

Parametri

[in] pwzIdentity

Specifica l'identità peer da esportare. Questo parametro è obbligatorio e non ha un valore predefinito.

[in] pwzPassword

Specifica la password da usare per crittografare l'identità peer. Questo parametro non può essere NULL. Questa password deve essere usata anche per importare l'identità peer oppure l'operazione di importazione ha esito negativo.

[out] ppwzExportXML

Riceve un puntatore all'identità peer esportata in formato XML. Se l'operazione di esportazione ha esito positivo, l'applicazione deve liberare ppwzExportXML chiamando PeerFreeData.

Valore restituito

Se la chiamata di funzione ha esito positivo, il valore restituito è S_OK. In caso contrario, restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_NO_KEY_ACCESS	L'accesso alle chiavi peer identity o peer group è stato negato. Questo è in genere causato da un elenco di controllo di accesso non corretto (ACL) per la cartella che contiene le chiavi utente o computer. Ciò può verificarsi quando l'ACL è stato reimpostato manualmente.
PEER_E_NOT_FOUND	L'identità peer specificata non esiste.

Commenti

Le credenziali di appartenenza al gruppo peer-to-peer non vengono esportate. Viene esportata solo un'identità peer. Un'identità peer esportata può essere importata in un altro computer usando PeerIdentityImport.

L'esportazione di un'identità peer non la rimuove da un ccmputer locale, ne esegue una copia. La copia può essere usata per eseguire il backup e ripristinare un'identità peer.

Il frammento XML usato da PeerIdentityExport è il seguente:

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

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop], Windows XP con SP1 con Advanced Networking Pack per Windows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PEER_DATA

PeerFreeData

PeerIdentityImport

Condividi tramite