PeerGraphConnect 関数 (p2p.h)

  • [アーティクル]

PeerGraphConnect 関数は、ピア グラフ内の指定されたノードへの接続を試行します。 この関数は非同期操作を開始します。 呼び出し元のアプリケーションは、接続試行が成功したかどうかを判断するために、 PEER_GRAPH_EVENT_NEIGHBOR_CONNECTION イベントを待機する必要があります。

構文

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

パラメーター

[in] hGraph

ピア グラフへの処理。

[in] pwzPeerId

pAddress で接続するピアの一意の ID。 同じピア グラフ内の指定したアドレスでリッスンしているピアに接続するには 、NULL を 指定します。

[in] pAddress

接続するノードを識別する PEER_ADDRESS 構造体へのポインター。

[out] pullConnectionId

接続 ID を含む ULONGLONG へのポインターを受け取ります。 この ID は、直接通信機能と共に使用できます。

戻り値

関数呼び出しが成功した場合、戻り値は S_OK。 それ以外の場合は、次のいずれかの値が返されます。

リターン コード 説明
E_INVALIDARG
 パラメーターの 1 つが無効です。
E_OUTOFMEMORY
 指定した操作を実行するのに十分なメモリがありません。
PEER_E_ALREADY_EXISTS
 指定したノードへの近隣接続が既に存在します。
PEER_E_INVALID_GRAPH
 ピア グラフへのハンドルが無効です。
PEER_E_NOT_INITIALIZED
 この関数を使用する前に、 PeerGraphStartup の呼び出しでグラフを初期化する必要があります。

要件

   
サポートされている最小のクライアント Windows XP と SP2 [デスクトップ アプリのみ],Windows XP SP1 と Advanced Networking Pack forWindows XP
サポートされている最小のサーバー サポートなし
対象プラットフォーム Windows
ヘッダー p2p.h
Library P2PGraph.lib
[DLL] P2PGraph.dll

関連項目

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData