PeerGroupSendData, fonction (p2p.h)

Article
03/01/2024

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