PeerDistClientAddData, fonction (peerdist.h)

Article
03/01/2024

La fonction PeerDistClientAddData est utilisée pour fournir du contenu au cache local. En règle générale, cette opération est effectuée lorsque les données sont introuvables sur le réseau local, comme indiqué lorsque PeerDistClientBlockRead ou PeerDistClientStreamRead se terminent avec ERROR_TIMEOUT ou PEERDIST_ERROR_MISSING_DATA.

Syntaxe

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

Paramètres

[in] hPeerDist

Une PEERDIST_INSTANCE_HANDLE retournée par PeerDistStartup.

[in] hContentHandle

Une PEERDIST_CONTENT_HANDLE retournée par PeerDistClientOpenContent.

cbNumberOfBytes

Nombre d’octets à ajouter au cache local.

[in] pBuffer

Pointeur vers la mémoire tampon qui contient les données à ajouter au cache local. Cette mémoire tampon doit rester valide pendant 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 CHEVAUCHÉE . Le décalage d’octets du début du contenu, auquel ces données sont ajoutées, est spécifié en définissant les membres Offset et OffsetHigh de la structure OVERLAPPED . Le membre OffsetHigh DOIT être défini sur les 32 bits supérieurs du décalage d’octets et le membre Offset DOIT être défini sur les 32 bits inférieurs du décalage d’octets.

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 ou hContent 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

Les données qui ont été ajoutées avec cette fonction et qui ont été vérifiées sont disponibles pour d’autres homologues ou le cache hébergé pour téléchargement. Le service peer distribution stocke ces données dans son cache local.

Si l’API se termine avec PEERDIST_ERROR_OUT_OF_BOUNDS, cela indique que le décalage spécifié dans la structure superposée est au-delà de la fin du contenu.

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

PeerDistClientBlockRead

PeerDistClientStreamRead

PeerDistStartup

Partager via