Funzione PeerIdentityImport (p2p.h)

Articolo
03/05/2024

La funzione PeerIdentityImport importa un'identità peer. Se l'identità peer esiste in un computer, PEER_E_ALREADY_EXISTS viene restituita.

Sintassi

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

Parametri

[in] pwzImportXML

Puntatore all'identità peer in formato XML da importare, restituita da PeerIdentityExport. Questi dati binari devono corrispondere al byte di dati esportato per byte. Il codice XML deve rimanere xml valido senza caratteri aggiuntivi.

[in] pwzPassword

Specifica la password da usare per decrittografare un'identità peer. La password deve essere identica alla password fornita a PeerIdentityExport. Questo parametro non può essere NULL.

[out] ppwzIdentity

Puntatore a una stringa che rappresenta un'identità peer importata. Se l'operazione di importazione ha esito positivo, l'applicazione deve liberare ppwzIdentity chiamando PeerFreeData.

Valore restituito

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

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido o i dati XML in ppwzImportXML sono stati manomessi.
E_OUTOFMEMORY	Memoria insufficiente per eseguire l'operazione specificata.
PEER_E_ALREADY_EXISTS	L'identità peer esiste già nel computer.
PEER_E_NO_KEY_ACCESS	L'accesso all'identità peer o alle chiavi del gruppo peer viene negato. In genere, ciò è 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.

Commenti

Il frammento XML usato da PeerIdentityImport è il seguente:

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

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

PeerIdentityExport

Condividi tramite