Fonction PeerDistClientAddContentInformation (peerdist.h)

Article
08/25/2023

La fonction PeerDistClientAddContentInformation ajoute les informations de contenu associées à un handle de contenu ouvert par PeerDistClientOpenContent.

Syntaxe

DWORD PeerDistClientAddContentInformation(
  [in] PEERDIST_INSTANCE_HANDLE hPeerDist,
  [in] PEERDIST_CONTENT_HANDLE  hContentHandle,
       DWORD                    cbNumberOfBytes,
  [in] PBYTE                    pBuffer,
  [in] LPOVERLAPPED             lpOverlapped
);

Paramètres

[in] hPeerDist

Un PEERDIST_INSTANCE_HANDLE retourné par PeerDistStartup.

[in] hContentHandle

Un PEERDIST_CONTENT_HANDLE ouvert par PeerDistClientOpenContent.

cbNumberOfBytes

Nombre d’octets dans le tableau pBuffer .

[in] pBuffer

Pointeur vers la mémoire tampon qui contient les informations de contenu. Cette mémoire tampon doit rester valide pendant toute la durée de l’opération d’ajout. L’appelant ne doit pas utiliser cette mémoire tampon tant que l’opération d’ajout n’est pas terminée.

[in] lpOverlapped

Pointeur vers une structure CHEVAUCHEMENT . Le membre interne de la structure CHEVAUCHEMENT CONTIENT la status d’achèvement de l’opération asynchrone. Les éléments Offset et OffsetHigh sont réservés et doivent être 0.

Valeur retournée

Si la fonction réussit, la valeur de retour est ERROR_IO_PENDING. Sinon, la fonction peut retourner l’une des valeurs suivantes :

Code de retour	Description
ERROR_INVALID_PARAMETER	Un ou plusieurs paramètres ne sont pas valides.
ERROR_INVALID_HANDLE	Le handle hPeerDist n’est pas valide.
ERROR_ACCESS_DISABLED_BY_POLICY	La fonctionnalité est désactivée par stratégie de groupe.
PEERDIST_ERROR_SERVICE_UNAVAILABLE	Le service n’est pas disponible.

Remarques

Pour récupérer des données de contenu à partir du service Peer Distribution, le client doit ajouter les informations de contenu qu’il a reçues du serveur de contenu en appelant la fonction PeerDistClientAddContentInformation . Lorsque toutes les données d’informations de contenu ont été ajoutées, la fonction PeerDistClientCompleteContentInformation doit être appelée. Une fois que PeerDistClientCompleteContentInformation est terminé, le client peut appeler PeerDistClientStreamRead ou PeerDistClientBlockRead pour récupérer les données du système de distribution d’homologues.

Lorsque vous appelez cette fonction plusieurs fois sur un seul handle de contenu, l’appelant doit attendre que chaque opération se termine avant d’effectuer l’appel suivant.

Une application ne se limite pas à l’ajout d’informations de contenu avec un seul appel d’API PeerDistClientAddContentInformation , car il est possible d’ajouter des parties de ces informations de contenu dès qu’elles sont mises à disposition. Lorsque d’autres informations de contenu sont disponibles, l’application peut à nouveau appeler PeerDistClientAddContentInformation. Lorsque l’application a terminé d’ajouter l’ensemble des informations de contenu, elle doit appeler PeerDistClientCompleteContentInformation.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 7 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 R2 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	peerdist.h
Bibliothèque	PeerDist.lib
DLL	PeerDist.dll

Voir aussi

PeerDistClientCompleteContentInformation

PeerDistClientOpenContent

PeerDistStartup

Partager via