Fungsi PeerIdentityGetXML (p2p.h)

Artikel
08/25/2023

Fungsi PeerIdentityGetXML mengembalikan deskripsi identitas serekan, yang kemudian dapat diteruskan ke pihak ketiga dan digunakan untuk mengundang identitas serekan ke dalam grup serekan. Informasi ini dikembalikan sebagai fragmen XML.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetXML(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzIdentityXML
);

Parameter

[in] pwzIdentity

Menentukan identitas serekan untuk mengambil informasi identitas serekan. Ketika parameter ini diteruskan sebagai NULL, identitas "default" akan dihasilkan untuk pengguna oleh infrastruktur serekan.

[out] ppwzIdentityXML

Penunjuk ke penunjuk ke string Unicode yang berisi fragmen XML. Ketika ppwzIdentityXML tidak lagi diperlukan, aplikasi bertanggung jawab untuk membebaskan string ini dengan memanggil PeerFreeData.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
E_HANDLE	Handel ke identitas tidak valid.
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.

Keterangan

Fragmen XML yang dikembalikan memiliki struktur berikut:

&lt;PEERIDENTITYINFO VERSION="1.0"&gt;
     &lt;IDC xmlns:dt="urn:schemas-microsoft-com:datatypes" dt:dt="bin.base64"&gt;
          Base 64 encoded certificate.
     &lt;/IDC&gt;
&lt;/PEERIDENTITYINFO&gt;

Fragmen XML ini digunakan saat membuat undangan untuk bergabung dengan grup.

Aplikasi tidak diizinkan untuk menambahkan tag dalam tag PEERIDENTITYINFO atau mengubah fragmen XML ini dengan cara apa pun. Aplikasi diizinkan untuk menggabungkan fragmen XML ini ke dalam dokumen XML lain, tetapi harus menghapus semua XML khusus aplikasi sebelum meneruskan fragmen ini ke PeerGroupCreateInvitation.

Persyaratan


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_CONTACT

PeerFreeData

PeerGroupCreateInvitation

Bagikan melalui