Fungsi PeerGroupConnect (p2p.h)
Fungsi PeerGroupConnect memulai pencarian PNRP untuk grup serekan dan mencoba menyambungkannya. Setelah fungsi ini berhasil dipanggil, serekan dapat berkomunikasi dengan anggota lain dari grup serekan.
Sintaks
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupConnect(
[in] HGROUP hGroup
);
Parameter
[in] hGroup
Tangani ke grup serekan yang ingin disambungkan oleh serekan. Handel ini dikembalikan oleh fungsi PeerGroupCreate, PeerGroupOpen,PeerGroupJoin, atau PeerGroupPasswordJoin. Parameter ini diperlukan.
Nilai kembali
Mengembalikan S_OK jika operasi berhasil. Jika tidak, fungsi mengembalikan nilai berikut.
| Menampilkan kode | Deskripsi |
|---|---|
|
Handel ke grup serekan tidak valid. |
Kesalahan khusus kriptografi dapat dikembalikan dari Penyedia Dasar Microsoft RSA. Kesalahan ini diawali dengan CRYPT_* dan didefinisikan dalam Winerror.h.
Keterangan
Aplikasi mendaftar untuk peristiwa serekan sebelum memanggil fungsi ini. Jika panggilan fungsi tidak berhasil, peristiwa PEER_GROUP_EVENT_CONNECTION_FAILED dinaikkan. Jika tidak, peristiwa PEER_GROUP_EVENT_STATUS_CHANGED akan dimunculkan.
Peristiwa PEER_GROUP_EVENT_CONNECTION_FAILED juga dinaikkan ketika pembuat grup gagal memanggil PeerGroupConnect segera setelah pembuatan. Jika ini tidak terjadi, pengguna yang diberi undangan akan berhasil memanggil PeerGroupConnect tetapi mereka tidak akan dapat mendengarkan dan akhirnya akan menerima peristiwa koneksi gagal.
Jika terjadi penyimpangan jam antara mesin yang berpartisipasi, keberhasilan PeerGroupConnect dapat bergantung pada tingkat keparahan kecondongan. Saat memecahkan masalah kegagalan untuk bergabung, kemungkinan ini harus dipertimbangkan dengan memverifikasi bahwa jam komputer disinkronkan.
Untuk hadir dalam grup serekan dan menerima peristiwa tetapi tetap tidak terhubung, gunakan fungsi PeerGroupOpen .
Jika nilai waktu habis untuk PeerGroupConnect tidak disediakan dalam aplikasi, mengalami kegagalan akan menyebabkan aplikasi macet. Nilai waktu habis 30 detik disarankan.
Sebelum memanggil PeerGroupConnect, grup ada dalam 'Status Terputus'. Selama waktu ini, grup tidak dapat dideteksi atau menerima koneksi. Untuk mengembalikan grup ke status ini, fungsi PeerGroupClose harus dipanggil.
Persyaratan
| Persyaratan | Nilai |
|---|---|
| Klien minimum yang didukung | Windows XP dengan SP2 [khusus aplikasi desktop],Windows XP dengan SP1 dengan Advanced Networking Pack forWindows XP |
| Server minimum yang didukung | Tidak ada yang didukung |
| Target Platform | Windows |
| Header | p2p.h |
| Pustaka | P2P.lib |
| DLL | P2P.dll |