Partager via


PeerGroupSendData, fonction (p2p.h)

La fonction PeerGroupSendData envoie des données à un membre via une connexion directe ou voisine.

Syntaxe

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

Paramètres

[in] hGroup

Gérez le groupe qui contient les deux membres d’une connexion. Ce handle est retourné par la fonction PeerGroupCreate, PeerGroupOpen ou PeerGroupJoin . Ce paramètre est obligatoire.

[in] ullConnectionId

Entier 64 bits non signé qui contient l’ID de la connexion qui héberge la transmission de données. Un ID de connexion est obtenu en appelant PeerGroupOpenDirectConnection. Ce paramètre est obligatoire.

[in] pType

Pointeur vers une valeur GUID qui identifie de manière unique les données transmises. Ce paramètre est obligatoire.

[in] cbData

Spécifie la taille des données dans pvData, en octets. Ce paramètre est obligatoire.

[in] pvData

Pointeur vers le bloc de données à envoyer. L’application réceptrice est responsable de l’analyse de ces données. Ce paramètre est obligatoire.

Valeur retournée

Retourne S_OK si l’opération réussit. Sinon, la fonction retourne l’une des valeurs suivantes.

Code de retour Description
E_INVALIDARG
L’un des paramètres n’est pas valide.
PEER_E_CONNECTION_NOT_FOUND
Impossible de trouver une connexion avec l’ID spécifié dans ullConnectionId .
 

Les erreurs spécifiques au chiffrement peuvent être retournées à partir du fournisseur de base Microsoft RSA. Ces erreurs sont préfixées par CRYPT_* et définies dans Winerror.h.

Remarques

Pour recevoir des données, l’homologue de réception doit s’être inscrit à l’événement PEER_GROUP_EVENT_INCOMING_DATA’homologue .

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows XP avec SP2 [applications de bureau uniquement],Windows XP avec SP1 avec le pack de mise en réseau avancé pour Windows XP
Serveur minimal pris en charge Aucun pris en charge
Plateforme cible Windows
En-tête p2p.h
Bibliothèque P2P.lib
DLL P2P.dll

Voir aussi

PeerGroupCloseDirectConnection

PeerGroupCreate

PeerGroupJoin

PeerGroupOpen

PeerGroupOpenDirectConnection