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 |