PeerGroupSendData-Funktion (p2p.h)

Artikel
03/13/2024

Die PeerGroupSendData-Funktion sendet Daten über eine benachbarte oder direkte Verbindung an ein Element.

Syntax

NOT_BUILD_WINDOWS_DEPRECATE HRESULT PeerGroupSendData(
  [in] HGROUP     hGroup,
  [in] ULONGLONG  ullConnectionId,
  [in] const GUID *pType,
  [in] ULONG      cbData,
  [in] PVOID      pvData
);

Parameter

[in] hGroup

Handle für die Gruppe, die beide Mitglieder einer Verbindung enthält. Dieses Handle wird von der Funktion PeerGroupCreate, PeerGroupOpen oder PeerGroupJoin zurückgegeben. Dieser Parameter ist erforderlich.

[in] ullConnectionId

64-Bit-Ganzzahl ohne Vorzeichen, die die ID der Verbindung enthält, die die Datenübertragung hostet. Eine Verbindungs-ID wird abgerufen, indem PeerGroupOpenDirectConnection aufgerufen wird. Dieser Parameter ist erforderlich.

[in] pType

Zeiger auf einen GUID-Wert , der die übertragenen Daten eindeutig identifiziert. Dieser Parameter ist erforderlich.

[in] cbData

Gibt die Größe der Daten in pvData in Bytes an. Dieser Parameter ist erforderlich.

[in] pvData

Zeiger auf den zu sendenden Datenblock. Die empfangende Anwendung ist für die Analyse dieser Daten verantwortlich. Dieser Parameter ist erforderlich.

Rückgabewert

Gibt S_OK zurück, wenn der Vorgang erfolgreich ist. Andernfalls gibt die Funktion einen der folgenden Werte zurück.

Rückgabecode	Beschreibung
E_INVALIDARG	Einer der Parameter ist ungültig.
PEER_E_CONNECTION_NOT_FOUND	Eine Verbindung mit der in ullConnectionId angegebenen ID wurde nicht gefunden.

Kryptografiespezifische Fehler können vom Microsoft RSA-Basisanbieter zurückgegeben werden. Diesen Fehlern wird CRYPT_* vorangestellt und in Winerror.h definiert.

Hinweise

Um Daten zu empfangen, muss sich der empfangende Peer für das PEER_GROUP_EVENT_INCOMING_DATA Peerereignis registriert haben.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP mit SP2 [nur Desktop-Apps],Windows XP mit SP1 mit dem Advanced Networking Pack forWindows XP
Unterstützte Mindestversion (Server)	Nicht unterstützt
Zielplattform	Windows
Kopfzeile	p2p.h
Bibliothek	P2P.lib
DLL	P2P.dll

Weitere Informationen

PeerGroupCloseDirectConnection

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupOpenDirectConnection

Freigeben über