Fungsi PeerGraphConnect (p2p.h)

Artikel
08/25/2023

Fungsi PeerGraphConnect mencoba membuat koneksi ke simpul tertentu dalam grafik serekan. Fungsi ini memulai operasi asinkron. Aplikasi panggilan harus menunggu peristiwa PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION untuk menentukan apakah upaya koneksi berhasil.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphConnect(
  [in]  HGRAPH        hGraph,
  [in]  PCWSTR        pwzPeerId,
  [in]  PPEER_ADDRESS pAddress,
  [out] ULONGLONG     *pullConnectionId
);

Parameter

[in] hGraph

Menangani grafik serekan.

[in] pwzPeerId

ID unik serekan untuk disambungkan di pAddress. Tentukan NULL untuk menyambungkan ke serekan apa pun yang mendengarkan di alamat tertentu dalam grafik serekan yang sama.

[in] pAddress

Penunjuk ke struktur PEER_ADDRESS yang mengidentifikasi simpul yang akan disambungkan.

[out] pullConnectionId

Menerima penunjuk ke ULONGLONG yang berisi ID koneksi. ID ini dapat digunakan dengan fungsi komunikasi langsung.

Menampilkan nilai

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

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_ALREADY_EXISTS	Koneksi tetangga ke simpul tertentu sudah ada.
PEER_E_INVALID_GRAPH	Handel ke grafik serekan tidak valid.
PEER_E_NOT_INITIALIZED	Grafik harus diinisialisasi dengan panggilan ke PeerGraphStartup sebelum menggunakan fungsi ini.

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	P2PGraph.lib
DLL	P2PGraph.dll

Lihat juga

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData

Bagikan melalui