Funzione PeerGroupSendData (p2p.h)

Articolo
03/05/2024

La funzione PeerGroupSendData invia dati a un membro tramite una connessione vicina o diretta.

Sintassi

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

Parametri

[in] hGroup

Handle per il gruppo che contiene entrambi i membri di una connessione. Questo handle viene restituito dalla funzione PeerGroupCreate, PeerGroupOpen o PeerGroupJoin . Questo parametro è obbligatorio.

[in] ullConnectionId

Intero senza segno a 64 bit che contiene l'ID della connessione che ospita la trasmissione dei dati. Un ID di connessione viene ottenuto chiamando PeerGroupOpenDirectConnection. Questo parametro è obbligatorio.

[in] pType

Puntatore a un valore GUID che identifica in modo univoco i dati trasmessi. Questo parametro è obbligatorio.

[in] cbData

Specifica le dimensioni dei dati in pvData, in byte. Questo parametro è obbligatorio.

[in] pvData

Puntatore al blocco di dati da inviare. L'applicazione ricevente è responsabile dell'analisi di questi dati. Questo parametro è obbligatorio.

Valore restituito

Restituisce S_OK se l'operazione ha esito positivo. In caso contrario, la funzione restituisce uno dei valori seguenti.

Codice restituito	Descrizione
E_INVALIDARG	Uno dei parametri non è valido.
PEER_E_CONNECTION_NOT_FOUND	Impossibile trovare una connessione con l'ID specificato in ullConnectionId .

Gli errori specifici della crittografia possono essere restituiti dal provider di base Microsoft RSA. Questi errori sono preceduti da CRYPT_* e definiti in Winerror.h.

Commenti

Per ricevere i dati, il peer ricevente deve essere registrato per l'evento peer PEER_GROUP_EVENT_INCOMING_DATA .

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP con SP2 [solo app desktop],Windows XP con SP1 con Advanced Networking Pack forWindows XP
Server minimo supportato	Nessuno supportato
Piattaforma di destinazione	Windows
Intestazione	p2p.h
Libreria	P2P.lib
DLL	P2P.dll

Vedi anche

PeerGroupCloseDirectConnection

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupOpenDirectConnection

Condividi tramite