Méthode IFillLockBytes::FillAppend (objidl.h)

La méthode FillAppend écrit un nouveau bloc d’octets à la fin d’un tableau d’octets.

Syntaxe

HRESULT FillAppend(
  [in]  const void *pv,
  [in]  ULONG      cb,
  [out] ULONG      *pcbWritten
);

Paramètres

[in] pv

Pointeur vers les données à ajouter à la fin d’un tableau d’octets existant. Cette opération ne crée pas de risque de fuite de mémoire ou de dépassement de mémoire tampon.

[in] cb

Taille de pv en octets.

[out] pcbWritten

Nombre d’octets qui ont été correctement écrits.

Valeur retournée

Cette fonction prend en charge les valeurs de retour standard E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG et E_FAIL.

Notes

La méthode FillAppend est utilisée pour le téléchargement séquentiel, où les octets sont écrits à la fin du tableau d’octets dans l’ordre dans lequel ils sont reçus. Cette méthode obtient la taille actuelle du tableau d’octets (par exemple, l’objet lockbytes) et écrit un nouveau bloc de données à la fin du tableau. À mesure que chaque bloc de données devient disponible, le téléchargeur appelle cette méthode pour l’écrire dans le tableau d’octets. Les appels suivants de l’implémentation de fichier composé à ILockBytes::ReadAt retournent toutes les données disponibles ou retournent E_PENDING si les données sont actuellement indisponibles.

Spécifications

Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau | Applications UWP]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau | Applications UWP]
Plateforme cible	Windows
En-tête	objidl.h
Bibliothèque	Uuid.lib
DLL	Ole32.dll

Voir aussi

ILockBytes