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
指定要发送数据的连接的唯一 ID。
[in] pType
指定要发送的应用程序定义的数据类型。 此参数不能为 NULL。
[in] cbData
指定 pvData 指向的字节数。
[in] pvData
指向要发送的数据的指针。
返回值
如果操作成功,则返回S_OK;否则,函数将返回以下值之一:
返回代码 | 说明 |
---|---|
|
其中一个参数无效。 |
|
不存在具有给定 ID 的连接。 |
|
对等图的句柄无效。 |
|
必须先通过调用 PeerGraphStartup 初始化图形,然后才能使用此函数。 |
注解
将数据发送到网络层后, PeerGraphSendData 函数将立即返回;对等图形层不会等待来自连接另一端的确认。
注意 为了能够通过直接连接接收数据,应用程序必须注册 PEER_GRAPH_EVENT_INCOMING_DATA类型的对等事件。 请参阅 PeerGraphRegisterEvent。
要求
要求 | 值 |
---|---|
最低受支持的客户端 | 具有 SP2 的 Windows XP [仅限桌面应用],具有 SP1 的 Windows XP 与高级网络包 forWindows XP |
最低受支持的服务器 | 无受支持的版本 |
目标平台 | Windows |
标头 | p2p.h |
Library | P2PGraph.lib |
DLL | P2PGraph.dll |