PeerGroupSendData-Funktion (p2p.h)

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.

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

Weitere Informationen

PeerGroupCloseDirectConnection

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupOpenDirectConnection