Fungsi PeerIdentityGetFriendlyName (p2p.h)

2024-03-04

Fungsi PeerIdentityGetFriendlyName mengembalikan nama yang mudah diingat dari identitas serekan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityGetFriendlyName(
  [in]  PCWSTR pwzIdentity,
  [out] PWSTR  *ppwzFriendlyName
);

Parameter

[in] pwzIdentity

Menentukan identitas serekan untuk mendapatkan nama yang mudah diingat.

[out] ppwzFriendlyName

Menerima penunjuk ke nama yang mudah diingat. Ketika ppwzFriendlyName tidak diperlukan lagi, aplikasi bertanggung jawab untuk membebaskan string ini 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. 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.
PEER_E_NOT_FOUND	Identitas serekan yang cocok dengan nama yang ditentukan tidak dapat ditemukan.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus 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

PeerFreeData

PeerIdentitySetFriendlyName