次の方法で共有

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 スコープを指定します。 有効な値を次の表に示します。 スコープの詳細については、「 Link-Local および Site-Local Addresses」を参照してください。

値 意味
PEER_GRAPH_SCOPE_GLOBAL
 スコープにはインターネットが含まれます。
PEER_GRAPH_SCOPE_SITELOCAL
 スコープは、企業イントラネットなどのサイトに制限されます。
PEER_GRAPH_SCOPE_LINKLOCAL
 スコープはローカル サブネットに制限されます。

[in] dwScopeId

リッスンする IPv6 スコープ ID を指定します。 指定したスコープのすべてのインターフェイスでリッスンするには、0 (0) を指定します。

メモdwScope がPEER_GRAPH_SCOPE_SITELOCALまたはPEER_GRAPH_SCOPE_LINKLOCALの場合、スコープ ID 0 (0) は許可されません。
 

[in] wPort

リッスンするポートを指定します。 動的ポートを使用するには、ゼロ (0) を指定します。 ゼロ (0) を指定した場合は、 PeerGraphGetNodeInfo を 使用してデータを取得します。

戻り値

操作 が成功した場合S_OK を返します。 それ以外の場合、関数は次の表で識別される値のいずれかを返します。

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_GRAPH_NOT_READY
 グラフが同期されていません。 ピア グラフが同期されるまで、アプリケーションはリッスンできません。
PEER_E_INVALID_GRAPH
 ピア グラフへのハンドルが無効です。
PEER_E_NOT_INITIALIZED
 この関数を使用する前に、 PeerGraphStartup の呼び出しでグラフを初期化する必要があります。

注釈

直接接続を受け入れるには、ノードが PEER_GRAPH_EVENT_DIRECT_CONNECTION イベントをサブスクライブする必要があります。

この関数を呼び出すには、アプリケーションで PeerGraphCreate または PeerGraphOpen を呼び出す必要があります。

メモ ピア グラフを初めて開く場合、ノードがピア グラフに接続してピア グラフと同期するまで 、PeerGraphListen へのすべての呼び出しは失敗します。
 
すべてのピア グラフが同じプロセスにある場合、アプリケーションは異なるピア グラフに同じポート ID を指定できます。

例

次のコード スニペットは、 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 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2PGraph.lib
[DLL] P2PGraph.dll

こちらもご覧ください

PeerGraphConnect

PeerGraphCreate

PeerGraphGetNodeInfo

PeerGraphOpen