Important:
This is retired content. This content is outdated and is no longer being maintained. It is provided as a courtesy for individuals who are still using these technologies. This content may contain URLs that were valid when originally published, but now link to sites or pages that no longer exist.
A version of this page is also available for
4/8/2010

This method writes a new block of bytes to the end of a byte array.

Syntax 

HRESULT FillAppend(
  void const* 
pv,
  ULONG 
cb,
  ULONG* 
pcbWritten 
);

Parameters

pv

[in] Pointer to the data to be appended to the end of an existing byte array.

cb

[in] Size of pvin bytes.

pcbWritten

[out] Number of bytes that were successfully written.

Return Value

This function supports the standard return values E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG, and E_FAIL.

Remarks

The FillAppendmethod is used for sequential downloading, where bytes are written to the end of the byte array in the order in which they are received.

This method obtains the current size of the byte array (for example, lockbytes object) and writes a new block of data to the end of the array.

As each block of data becomes available, the downloader calls this method to write it to the byte array. Subsequent calls by the compound file implementation to ILockBytes::ReadAtreturn any available data or return E_PENDING if data is unavailable.

To determine whether the platform supports this interface, see Determining Supported COM APIs.

Requirements

Header objidl.h, objidl.idl
Library ole32.lib, uuid.lib
Windows Embedded CE Windows CE 3.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

ILockBytes