Fungsi PeerCreatePeerName (p2p.h)

Fungsi PeerCreatePeerName membuat nama baru berdasarkan nama identitas serekan dan pengklasifikasi yang ditentukan. Namun, identitas baru tidak dibuat oleh panggilan ke PeerCreatePeerName.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerCreatePeerName(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzClassifier,
  [out] PWSTR  *ppwzPeerName
);

Parameter

[in] pwzIdentity

Menentukan identitas yang akan digunakan sebagai dasar untuk nama serekan baru. Jika pwzIdentity adalah NULL, nama yang dibuat tidak didasarkan pada identitas serekan apa pun, dan oleh karena itu merupakan nama yang tidak aman.

Parameter ini hanya dapat berupa NULL jika pwzClassifier bukan NULL.

[in] pwzClassifier

Penunjuk ke string Unicode yang berisi pengklasifikasi baru. Pengklasifikasi ini ditambahkan ke bagian otoritas yang ada dari nama serekan identitas yang ditentukan. Panjang string ini adalah 150 karakter, termasuk terminator NULL . Tentukan NULL untuk mengembalikan nama serekan identitas.

Parameter ini hanya dapat berupa NULL jika pwzIdentity bukan NULL.

[out] ppwzPeerName

Penunjuk yang menerima penunjuk ke nama serekan baru. Ketika string ini tidak diperlukan lagi, bebaskan dengan memanggil PeerFreeData.

Nilai kembali

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

Keterangan

Parameter ppwzPeername harus diatur ke null sebelum fungsi PeerCreatePeerName dipanggil.

Persyaratan

Lihat juga

PeerFreeData