Fungsi PeerIdentityCreate (p2p.h)

Artikel
03/01/2024

Fungsi PeerIdentityCreate membuat identitas serekan baru dan mengembalikan namanya. Nama identitas serekan harus diteruskan dalam semua panggilan berikutnya ke fungsi Peer Identity Manager, Peer Grouping, atau PNRP yang beroperasi atas nama identitas serekan. Nama identitas serekan menentukan identitas serekan mana yang sedang digunakan.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerIdentityCreate(
  [in]  PCWSTR     pwzClassifier,
  [in]  PCWSTR     pwzFriendlyName,
  [in]  HCRYPTPROV hCryptProv,
  [out] PWSTR      *ppwzIdentity
);

Parameter

[in] pwzClassifier

Menentukan pengklasifikasi untuk ditambahkan ke nama identitas serekan yang diterbitkan. String ini adalah string Unicode, dan dapat berupa NULL. Panjang string ini hanya boleh 150 karakter, termasuk terminator NULL .

[in] pwzFriendlyName

Menentukan nama yang mudah diingat dari identitas serekan. Ini adalah untai (karakter) Unicode, dan dapat berupa NULL. Panjang string ini hanya boleh 256 karakter, termasuk terminator NULL . Jika pwzFriendlyName adalah NULL, nama identitas adalah nama yang mudah diingat. Nama yang mudah diingat bersifat opsional, dan tidak harus unik.

[in] hCryptProv

Tangani ke penyedia layanan kriptografi (CSP) yang berisi pasangan kunci AT_KEYEXCHANGE dengan panjang setidaknya 1024 bit. Pasangan kunci ini digunakan sebagai dasar untuk identitas serekan baru. Jika hCryptProv adalah nol (0), pasangan kunci baru dihasilkan untuk identitas serekan.

Catatan IDENTITY Manager API tidak mendukung CSP yang memiliki kunci yang dilindungi pengguna. Jika CSP yang memiliki kunci yang dilindungi pengguna digunakan, PeerIdentityCreate mengembalikan E_INVALIDARG.

[out] ppwzIdentity

Menerima penunjuk ke nama identitas serekan yang dibuat. Nama ini harus digunakan dalam semua panggilan berikutnya ke fungsi Peer Identity Manager, Peer Grouping, atau PNRP yang beroperasi atas nama identitas serekan. Mengembalikan NULL jika identitas serekan tidak dapat dibuat.

Nilai kembali

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

Menampilkan kode	Deskripsi
ERROR_INVALID_HANDLE	Handel ke kunci yang ditentukan oleh hCryptProv tidak valid.
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_ALREADY_EXISTS	Identitas serekan sudah ada. Hanya terjadi jika identitas serekan berdasarkan kunci dan pengklasifikasi yang ditentukan sudah ada.
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_TOO_MANY_IDENTITIES	Identitas serekan tidak dapat dibuat karena ada terlalu banyak identitas serekan.

Keterangan

Pasangan kunci dan pengklasifikasi digunakan untuk menghasilkan nama serekan identitas serekan baru. Setelah identitas serekan dibuat, identitas tersebut secara otomatis disimpan di disk.

Nama identitas harus dibebaskan dengan menggunakan PeerFreeData. Ini tidak menghapus identitas serekan. Untuk menghapus identitas, gunakan fungsi PeerIdentityDelete .

Jika hCryptProv bukan NULL, itu dapat dirilis dengan menggunakan CryptReleaseContext setelah panggilan kembali.

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

CryptReleaseContext

PeerFreeData

PeerIdentityDelete

Bagikan melalui