Fungsi PeerGroupPasswordJoin (p2p.h)

Artikel
03/15/2023

Fungsi PeerGroupPasswordJoin menyiapkan serekan dengan undangan dan kata sandi yang benar untuk bergabung dengan grup serekan yang dilindungi kata sandi sebelum memanggil PeerGroupConnect atau PeerGroupConnectByAddress.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupPasswordJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [in]  PCWSTR pwzPassword,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parameter

[in] pwzIdentity

Penunjuk ke string Unicode yang berisi identitas yang membuka grup serekan yang ditentukan. Jika parameter ini NULL, implementasinya menggunakan identitas yang diperoleh dari PeerIdentityGetDefault.

[in] pwzInvitation

Penunjuk ke string Unicode yang berisi undangan XML yang diberikan oleh peer lain. Undangan dengan kata sandi dibuat saat serekan yang mengundang memanggil PeerGroupCreatePasswordInvitation. Detail spesifik mengenai undangan ini, termasuk kata sandi yang ditetapkan oleh pembuat grup, dapat diperoleh sebagai struktur PEER_INVITATION_INFO dengan memanggil PeerGroupParseInvitation. Parameter ini diperlukan.

[in] pwzPassword

Penunjuk ke string Unicode yang dihentikan nol yang berisi kata sandi yang diperlukan untuk memvalidasi dan bergabung dengan grup serekan. Kata sandi ini harus cocok dengan kata sandi yang ditentukan dalam undangan. Parameter ini diperlukan.

[in] pwzCloud

Penunjuk ke string Unicode yang berisi nama cloud PNRP tempat grup berada. Nilai defaultnya adalah NULL, yang menunjukkan bahwa cloud yang ditentukan dalam undangan harus digunakan.

[out] phGroup

Penunjuk ke handel grup serekan. Untuk memulai komunikasi dengan grup, panggil PeerGroupConnect. Parameter ini diperlukan.

Nilai kembali

Mengembalikan S_OK jika operasi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Tidak tersedia cukup memori untuk menyelesaikan operasi.
PEER_E_CLOUD_NAME_AMBIGUOUS	Cloud tidak dapat ditemukan secara unik, misalnya, lebih dari satu cloud cocok dengan nama yang disediakan.
PEER_E_INVALID_PEER_NAME	Identitas serekan yang ditentukan dalam pwzIdentity tidak valid.
PEER_E_INVITATION_NOT_TRUSTED	Undangan tidak dipercaya oleh serekan. Ini telah diubah atau berisi kesalahan.
PEER_E_NO_CLOUD	Cloud tidak dapat ditemukan.
PEER_E_UNSUPPORTED_VERSION	Undangan tidak didukung oleh versi Infrastruktur Serekan saat ini.
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_S_ALREADY_A_MEMBER	Serekan lokal mencoba bergabung dengan grup berdasarkan kata sandi lebih dari sekali.

Kesalahan khusus kriptografi dapat dikembalikan dari Penyedia Dasar Microsoft RSA. Kesalahan ini diawali dengan CRYPT_* dan didefinisikan dalam Winerror.h.

Keterangan

Jika terjadi penyimpangan jam antara mesin yang berpartisipasi, fungsi PeerGroupPasswordJoin awal mungkin masih berhasil sementara panggilan PeerGroupConnect berikut dapat mengakibatkan kegagalan untuk bergabung tergantung pada tingkat keparahan condong.

Persyaratan

Persyaratan	Nilai
Klien minimum yang didukung	Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Paket Jaringan Tingkat Lanjut untukWindows XP
Server minimum yang didukung	Tidak ada yang didukung
Target Platform	Windows
Header	p2p.h
Pustaka	P2P.lib
DLL	P2P.dll

Lihat juga

PeerGroupConnect

PeerGroupConnectByAddress

Bagikan melalui