Fungsi PeerIdentityImport (p2p.h)

Artikel
03/04/2024

Fungsi PeerIdentityImport mengimpor satu identitas serekan. Jika identitas serekan ada di komputer, PEER_E_ALREADY_EXISTS dikembalikan.

Sintaks

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

Parameter

[in] pwzImportXML

Arahkan ke identitas serekan format XML untuk diimpor, yang dikembalikan oleh PeerIdentityExport. Data biner ini harus cocok dengan data byte-for-byte yang diekspor. XML harus tetap valid XML tanpa karakter tambahan.

[in] pwzPassword

Menentukan kata sandi yang akan digunakan untuk mendekripsi identitas serekan. Kata sandi harus identik dengan kata sandi yang disediakan ke PeerIdentityExport. Parameter ini tidak boleh NULL.

[out] ppwzIdentity

Penunjuk ke string yang mewakili identitas serekan yang diimpor. Jika operasi impor berhasil, aplikasi harus membebaskan ppwzIdentity dengan memanggil PeerFreeData.

Nilai kembali

Jika panggilan fungsi berhasil, nilai yang dikembalikan adalah S_OK. Jika tidak, ia mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid, atau data XML di ppwzImportXML telah dirusak.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_ALREADY_EXISTS	Identitas serekan sudah ada pada komputer ini.
PEER_E_NO_KEY_ACCESS	Akses ke identitas serekan atau kunci grup serekan ditolak. Biasanya, ini disebabkan oleh daftar kontrol akses (ACL) yang salah untuk folder yang berisi kunci pengguna atau komputer. Ini dapat terjadi ketika ACL telah direset secara manual.

Keterangan

Fragmen XML yang digunakan oleh PeerIdentityImport adalah sebagai berikut:

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

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [hanya aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untuk Windows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2P.lib
DLL	P2P.dll

Lihat juga

PEER_DATA

PeerFreeData

PeerIdentityExport

Bagikan melalui