Fungsi PeerGroupOpen (p2p.h)

Artikel
08/25/2023

Fungsi PeerGroupOpen membuka grup serekan yang telah dibuat atau digabungkan oleh serekan. Setelah grup serekan dibuka, rekan dapat mendaftar untuk pemberitahuan peristiwa.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupOpen(
  [in]  PCWSTR pwzIdentity,
  [in]  PCWSTR pwzGroupPeerName,
  [in]  PCWSTR pwzCloud,
  [out] HGROUP *phGroup
);

Parameter

[in] pwzIdentity

Penunjuk ke string Unicode yang berisi identitas yang digunakan serekan untuk membuka grup. Parameter ini diperlukan.

[in] pwzGroupPeerName

Penunjuk ke string Unicode yang berisi nama serekan grup serekan. Parameter ini diperlukan.

[in] pwzCloud

Penunjuk ke string Unicode yang berisi nama cloud PNRP tempat grup serekan berada. Jika nilainya ADALAH NULL, cloud yang ditentukan dalam properti grup serekan digunakan.

[out] phGroup

Penunjuk ke handel untuk grup serekan. Jika nilai ini NULL, operasi terbuka tidak berhasil. 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 yang ditentukan dalam pwzCloud tidak dapat ditemukan secara unik, misalnya, lebih dari satu cloud cocok dengan nama yang disediakan.
PEER_E_NO_CLOUD	Cloud yang ditentukan dalam pwzCloud tidak dapat ditemukan.
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.

Keterangan

Beberapa aplikasi dapat membuka grup yang sama secara bersamaan. Aplikasi apa pun dapat memilih untuk membuka grup tanpa kemudian memanggil PeerGroupConnect. Aplikasi ini dianggap offline. Namun, aplikasi kedua dapat membuka dan menghubungkan serekan ke grup, yang berarti bahwa aplikasi harus siap untuk terhubung kapan saja.

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

Bagikan melalui