共用方式為

peerGraphListen 函式 (p2p.h)

  • 發行項

PeerGraphListen 函式表示對等圖形應該開始接聽連入連線。

語法

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

參數

[in] hGraph

指定要接聽的對等圖形。

[in] dwScope

指定要接聽的 IPv6 範圍。 下表會識別有效的值。 如需範圍的詳細資訊，請參閱 連結本機和 Site-Local 位址。

值 意義
PEER_GRAPH_SCOPE_GLOBAL
 範圍包括因特網。
PEER_GRAPH_SCOPE_SITELOCAL
 範圍僅限於網站，例如公司內部網路。
PEER_GRAPH_SCOPE_LINKLOCAL
 範圍限制為本機子網。

[in] dwScopeId

指定要接聽的 IPv6 範圍標識碼。 指定零 (0) 接聽指定範圍的所有介面。

注意 如果 dwScope 是 PEER_GRAPH_SCOPE_SITELOCAL 或PEER_GRAPH_SCOPE_LINKLOCAL，則不允許範圍標識元零 (0 ) 。
 

[in] wPort

指定要接聽的埠。 指定零 (0) 以使用動態埠。 如果指定零 (0) ，請使用 PeerGraphGetNodeInfo 來擷取數據。

傳回值

如果作業成功，則傳回 S_OK 。 否則，函式會傳回下表中所識別的其中一個值。

傳回碼 Description
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_GRAPH_NOT_READY
 圖表從未同步處理過。 應用程式在同步處理對等圖形之前無法接聽。
PEER_E_INVALID_GRAPH
 對等圖形的句柄無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先使用 對PeerGraphStartup的呼叫來初始化圖形。

備註

若要能夠接受直接連線，節點必須訂閱 PEER_GRAPH_EVENT_DIRECT_CONNECTION 事件。

在呼叫此函式之前，應用程式必須呼叫 PeerGraphCreate 或 PeerGraphOpen。

注意 如果這是第一次開啟對等圖形時，對 PeerGraphListen 的所有呼叫都會失敗，直到節點連線到對等圖形並與其同步處理為止。
 
如果所有對等圖形都在相同的進程中，應用程式可以針對不同的對等圖形指定相同的埠識別碼。

範例

下列代碼段示範如何使用 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.
    }

規格需求

需求 值
最低支援的用戶端 Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件
最低支援的伺服器 都不支援
目標平台 Windows
標頭 p2p.h
程式庫 P2PGraph.lib
Dll P2PGraph.dll

另請參閱

PeerGraphConnect

PeerGraphCreate

PeerGraphGetNodeInfo

PeerGraphOpen