IWSDInboundAttachment ::Read, méthode (wsdattachment.h)

Article
03/09/2024

Récupère les données de pièce jointe à partir d’un message envoyé par un hôte distant.

Syntaxe

HRESULT Read(
  [out] BYTE    *pBuffer,
  [in]  DWORD   dwBytesToRead,
  [out] LPDWORD pdwNumberOfBytesRead
);

Paramètres

[out] pBuffer

Pointeur vers une mémoire tampon recevant les données lues à partir du flux de pièces jointes. Le programme d’application est responsable de l’allocation et de la libération de cette mémoire tampon de données.

[in] dwBytesToRead

Taille de la mémoire tampon d’entrée pBuffer , en octets.

[out] pdwNumberOfBytesRead

Pointeur vers un DWORD contenant le nombre d’octets de données lus à partir du flux de pièces jointes dans la mémoire tampon d’entrée pBuffer .

Valeur retournée

Les valeurs de retour possibles incluent, sans s’y limiter, les éléments suivants :

Code de retour	Description
S_OK	Méthode terminée avec succès.
S_FALSE	La fin du flux de pièces jointes a été atteinte.
E_INVALIDARG	pBuffer a la valeur NULL.
E_POINTER	pdwNumberofBytesRead a lavaleur NULL.

Remarques

La méthode Read permet à une application de recevoir des données arbitraires d’un hôte distant dans une pièce jointe de message encapsulé MIME. WSDAPI fournit un objet implémentant cette interface lorsqu’un flux de pièces jointes est reçu dans le cadre d’un message. L’appel à Read ouvre le flux de pièces jointes entrantes et transfère les données de pièce jointe vers la mémoire tampon de l’application. Si Read retourne S_OK ou S_FALSE, pdwNumberofBytesRead est défini sur le nombre d’octets lus, qui peut être inférieur à la taille de la mémoire tampon. L’appel en lecture peut bloquer le trafic réseau.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	wsdattachment.h (inclure Wsdapi.h)
DLL	Wsdapi.dll

Voir aussi

IWSDInboundAttachment

Partager via