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
不帶正負號的64位整數，其中包含裝載數據傳輸之聯機的標識碼。 呼叫 PeerGroupOpenDirectConnection 來取得連線標識碼。 此為必要參數。
[in] pType
GUID 值的指標，可唯一識別正在傳輸的數據。 此為必要參數。
[in] cbData
指定 pvData 中的數據大小，以位元組為單位。 此為必要參數。
[in] pvData
要傳送之數據區塊的指標。 接收的應用程式負責剖析此數據。 此為必要參數。
傳回值
如果作業成功，則傳回 S_OK 。 否則，函式會傳回下列其中一個值。
| 傳回碼 | Description |
|---|---|
|
其中一個參數無效。 |
|
找不到具有 ullConnectionId 中所指定標識碼的連接。 |
密碼編譯特定錯誤可以從 Microsoft RSA 基底提供者傳回。 這些錯誤前面會加上 CRYPT_* 並在 Winerror.h 中定義。
備註
若要接收數據，接收端對等必須已註冊 PEER_GROUP_EVENT_INCOMING_DATA 對等事件。
規格需求
| 需求 | 值 |
|---|---|
| 最低支援的用戶端 | Windows XP 搭配 SP2 [僅限傳統型應用程式]，Windows XP 含 SP1 與 Windows XP 的進階網络套件 |
| 最低支援的伺服器 | 都不支援 |
| 目標平台 | Windows |
| 標頭 | p2p.h |
| 程式庫 | P2P.lib |
| Dll | P2P.dll |