共用方式為

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之對等的唯一識別碼。 指定 Null ，以連線到在相同對等圖形中接聽指定位址的任何對等。

[in] pAddress

識別要連線之節點 之PEER_ADDRESS 結構的指標。

[out] pullConnectionId

接收包含連接識別碼的 ULONGLONG 指標。 此識別碼可與直接通訊函式搭配使用。

傳回值

如果函式呼叫成功，傳回值 會S_OK。 否則，它會傳回下列其中一個值。

傳回碼 描述
E_INVALIDARG
 其中一個參數無效。
E_OUTOFMEMORY
 記憶體不足，無法執行指定的作業。
PEER_E_ALREADY_EXISTS
 已存在與指定節點的鄰近連接。
PEER_E_INVALID_GRAPH
 對等圖形的控制碼無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先使用 對 PeerGraphStartup 的呼叫來初始化圖形。

需求

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

另請參閱

PEER_ADDRESS

PeerGraphGetEventData

PeerGraphListen

PeerGraphOpenDirectConnection

PeerGraphSendData