peerGroupSendData 函数 (p2p.h)
PeerGroupSendData 函数通过邻居或直接连接将数据发送到成员。
语法
NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSendData(
[in] HGROUP hGroup,
[in] ULONGLONG ullConnectionId,
[in] const GUID *pType,
[in] ULONG cbData,
[in] PVOID pvData
);
参数
[in] hGroup
包含连接两个成员的组的句柄。 此句柄由 PeerGroupCreate、 PeerGroupOpen 或 PeerGroupJoin 函数返回。 此参数是必需的。
[in] ullConnectionId
包含托管数据传输的连接 ID 的无符号 64 位整数。 连接 ID 是通过调用 PeerGroupOpenDirectConnection 获取的。 此参数是必需的。
[in] pType
指向唯一标识所传输数据的 GUID 值的指针。 此参数是必需的。
[in] cbData
以 pvData 为单位指定数据的大小（以字节为单位）。 此参数是必需的。
[in] pvData
指向要发送的数据块的指针。 接收应用程序负责分析此数据。 此参数是必需的。
返回值
如果操作成功，则返回 S_OK 。 否则，该函数返回以下值之一。
| 返回代码 | 说明 |
|---|---|
|
其中一个参数无效。 |
|
找不到具有 ullConnectionId 中指定的 ID 的连接。 |
可以从 Microsoft RSA 基础提供程序返回特定于加密的错误。 这些错误以 CRYPT_* 为前缀，并在 Winerror.h 中定义。
注解
若要接收数据，接收对等方必须已注册 PEER_GROUP_EVENT_INCOMING_DATA 对等事件。
要求
| 要求 | 值 |
|---|---|
| 最低受支持的客户端 | 带 SP2 的 Windows XP [仅限桌面应用]，带 SP1 的 Windows XP 以及适用于 Windows XP 的高级网络包 |
| 最低受支持的服务器 | 无受支持的版本 |
| 目标平台 | Windows |
| 标头 | p2p.h |
| Library | P2P.lib |
| DLL | P2P.dll |