Fungsi PeerGraphListen (p2p.h)

Artikel
03/01/2024

Fungsi PeerGraphListen menunjukkan bahwa grafik serekan harus mulai mendengarkan koneksi masuk.

Sintaks

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphListen(
  [in] HGRAPH hGraph,
  [in] DWORD  dwScope,
  [in] DWORD  dwScopeId,
  [in] WORD   wPort
);

Parameter

[in] hGraph

Menentukan grafik serekan untuk didengarkan.

[in] dwScope

Menentukan cakupan IPv6 untuk didengarkan. Nilai yang valid diidentifikasi dalam tabel berikut. Untuk informasi selengkapnya tentang cakupan, lihat Alamat Link-Lokal dan Site-Local.

Nilai	Makna
PEER_GRAPH_SCOPE_GLOBAL	Cakupan mencakup Internet.
PEER_GRAPH_SCOPE_SITELOCAL	Cakupan dibatasi untuk situs, misalnya, intranet perusahaan.
PEER_GRAPH_SCOPE_LINKLOCAL	Cakupan dibatasi untuk subnet lokal.

[in] dwScopeId

Menentukan ID cakupan IPv6 untuk didengarkan. Tentukan nol (0) untuk mendengarkan semua antarmuka dari cakupan yang ditentukan.

Catatan ID cakupan nol (0) tidak diizinkan jika dwScopePEER_GRAPH_SCOPE_SITELOCAL atau PEER_GRAPH_SCOPE_LINKLOCAL.

[in] wPort

Menentukan port yang akan didengarkan. Tentukan nol (0) untuk menggunakan port dinamis. Jika nol (0) ditentukan, gunakan PeerGraphGetNodeInfo untuk mengambil data.

Nilai kembali

Mengembalikan S_OK jika operasi berhasil. Jika tidak, fungsi mengembalikan salah satu nilai yang diidentifikasi dalam tabel berikut.

Menampilkan kode	Deskripsi
E_INVALIDARG	Salah satu parameter tidak valid.
E_OUTOFMEMORY	Memori tidak cukup untuk melakukan operasi yang ditentukan.
PEER_E_GRAPH_NOT_READY	Grafik belum pernah disinkronkan. Aplikasi tidak dapat mendengarkan sampai grafik serekan telah disinkronkan.
PEER_E_INVALID_GRAPH	Handel ke grafik peer tidak valid.
PEER_E_NOT_INITIALIZED	Grafik harus diinisialisasi dengan panggilan ke PeerGraphStartup—sebelum menggunakan fungsi ini.

Keterangan

Agar dapat menerima koneksi langsung, simpul harus berlangganan peristiwa PEER_GRAPH_EVENT_DIRECT_CONNECTION .

Sebelum fungsi ini dapat dipanggil, aplikasi harus memanggil PeerGraphCreate atau PeerGraphOpen.

Catatan Jika ini pertama kalinya grafik serekan dibuka, semua panggilan ke PeerGraphListen gagal hingga simpul tersambung dan disinkronkan dengan grafik serekan.

Aplikasi dapat menentukan ID port yang sama untuk grafik serekan yang berbeda, jika semua grafik serekan berada dalam proses yang sama.

Contoh

Cuplikan kode berikut menunjukkan cara menggunakan fungsi PeerGraphListen .

    // g_hGraph is a handle to the Graph obtained from a previous successful call to PeerGraphCreate or PeerGraphOpen.
    // dwScope should be set to the same scope used to create the graph.  This example assumes the graph was created in the Global scope.
    // g_usPort is the port to use for Graphing.  Use zero to obtain a port dynamically.
    HRESULT hr = PeerGraphListen(g_hGraph, PEER_GRAPH_SCOPE_GLOBAL, 0, g_usPort);

    if (FAILED(hr))
    {
        // Insert your code to handle the error here.
    }
    else
    {
        // Insert your application specific code here.
    }

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

Lihat juga

Bagikan melalui