Fungsi PeerIdentityExport (p2p.h)

Artikel
03/01/2024

Fungsi PeerIdentityExport memungkinkan pengguna untuk mengekspor satu identitas serekan. Pengguna kemudian dapat mentransfer identitas serekan ke komputer lain.

Sintaks

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

Parameter

[in] pwzIdentity

Menentukan identitas serekan yang akan diekspor. Parameter ini diperlukan dan tidak memiliki nilai default.

[in] pwzPassword

Menentukan kata sandi yang akan digunakan untuk mengenkripsi identitas serekan. Parameter ini tidak boleh NULL. Kata sandi ini juga harus digunakan untuk mengimpor identitas serekan, atau operasi impor gagal.

[out] ppwzExportXML

Menerima penunjuk ke identitas serekan yang diekspor dalam format XML. Jika operasi ekspor berhasil, aplikasi harus membebaskan ppwzExportXML 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.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_NO_KEY_ACCESS	Akses ke identitas serekan atau kunci grup serekan ditolak. Hal ini biasanya 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.
PEER_E_NOT_FOUND	Identitas serekan yang ditentukan tidak ada.

Keterangan

Kredensial keanggotaan grup peer-to-peer tidak diekspor. Hanya satu identitas serekan yang diekspor. Identitas serekan yang diekspor dapat diimpor di komputer lain dengan menggunakan PeerIdentityImport.

Mengekspor identitas serekan tidak menghapusnya dari ccmputer lokal, itu membuat salinannya. Salinan dapat digunakan untuk mencadangkan dan memulihkan identitas serekan.

Fragmen XML yang digunakan oleh PeerIdentityExport adalah sebagai berikut:

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

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

PeerIdentityImport

Bagikan melalui