peerGraphSendData 函式 (p2p.h)
PeerGraphSendData 函式會將數據傳送至鄰近節點或直接連接的節點。
語法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGraphSendData(
[in] HGRAPH hGraph,
[in] ULONGLONG ullConnectionId,
[in] const GUID *pType,
[in] ULONG cbData,
[in] PVOID pvData
);
參數
[in] hGraph
對等圖形的句柄。
[in] ullConnectionId
指定要傳送數據之連線的唯一標識碼。
[in] pType
指定要傳送的應用程式定義資料類型。 此參數不可為 NULL。
[in] cbData
指定 pvData 所指向的位元組數目。
[in] pvData
要傳送之數據的指標。
傳回值
如果作業成功,則傳回S_OK;否則,函式會傳回下列其中一個值:
傳回碼 | Description |
---|---|
|
其中一個參數無效。 |
|
沒有具有指定識別碼的連接。 |
|
對等圖形的句柄無效。 |
|
使用這個函式之前,必須先使用 對PeerGraphStartup 的呼叫來初始化圖形。 |
備註
PeerGraphSendData 函式會在數據傳送至網路層時立即傳回;對等圖形層不會等候連接另一端的通知。
注意 若要能夠接收具有直接連線的數據,應用程式必須註冊 類型為 PEER_GRAPH_EVENT_INCOMING_DATA 的對等事件。 請參閱 PeerGraphRegisterEvent。
規格需求
需求 | 值 |
---|---|
最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式],Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
最低支援的伺服器 | 都不支援 |
目標平台 | Windows |
標頭 | p2p.h |
程式庫 | P2PGraph.lib |
Dll | P2PGraph.dll |