Fungsi PeerGroupJoin (p2p.h)

Artikel
08/25/2023

Fungsi PeerGroupJoin menyiapkan serekan dengan undangan untuk bergabung dengan grup serekan yang ada sebelum memanggil PeerGroupConnect atau PeerGroupConnectByAddress.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupJoin(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzInvitation,
  [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 dibuat saat serekan yang mengundang memanggil PeerGroupCreateInvitation atau PeerGroupIssueCredentials. Detail spesifik mengenai undangan ini dapat diperoleh sebagai struktur PEER_INVITATION_INFO dengan memanggil PeerGroupParseInvitation. 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.

Menampilkan nilai

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_INVALID_TIME_PERIOD	Periode validitas yang ditentukan dalam undangan tidak valid. Periode yang ditentukan telah kedaluwarsa atau undangan belum valid (yaitu tanggal\waktu ValidityStart yang ditentukan belum tercapai). Salah satu alasan yang mungkin untuk kembalinya kesalahan ini adalah bahwa jam sistem salah diatur pada mesin yang bergabung dengan grup, atau pada komputer yang mengeluarkan undangan.
PEER_E_INVITATION_NOT_TRUSTED	Undangan tidak tepercaya. Ini mungkin karena perubahan undangan, kesalahan, atau kedaluwarsa.
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.

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

Persyaratan


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

PEER_INVITATION_INFO

PeerGroupConnect

PeerGroupConnectByAddress

PeerGroupCreateInvitation

PeergroupBuka

PeerGroupParseInvitation

Bagikan melalui