共用方式為

peerGraphOpenDirectConnection 函式 (p2p.h)

  • 發行項

PeerGraphOpenDirectConnection 函式可讓應用程式與對等圖形中的節點建立直接連線。 只有在應用程式連接的節點已訂閱 PEER_GRAPH_EVENT_DIRECT_CONNECTION 事件時，才能建立連線。 然後，應用程式可以將數據直接傳送至另一個節點。 呼叫此函式是異步的。

語法

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

參數

[in] hGraph

對等圖形的句柄。

[in] pwzPeerId

要連線之用戶或節點的唯一標識符指標。 此參數可用來識別特定使用者，因為多個身分識別可以附加至指定的位址。

[in] pAddress

包含要連線之節點位址 的PEER_ADDRESS 結構的指標。

[out] pullConnectionId

接收所要求連線的連線標識碼。

傳回值

如果函數調用成功，傳回值會 S_OK。 否則，它會傳回下列其中一個值。

傳回碼 Description
PEER_E_INVALID_GRAPH
 圖形的句柄無效。
PEER_E_NOT_INITIALIZED
 使用這個函式之前，必須先使用 對PeerGraphStartup的呼叫來初始化圖形。

備註

對 PeerGraphOpenDirectConnection 的呼叫是異步呼叫。 觸發 PEER_GRAPH_EVENT_DIRECT_CONNECTION 事件，以通知應用程式直接連線的成功或失敗。 函式成功或失敗的實際狀態會在 PEER_GRAPH_EVENT_DATA 結構中指定。

規格需求

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

另請參閱

PEER_ADDRESS

PeerGraphCloseDirectConnection

PeerGraphEnumConnections