IFillLockBytes::FillAppend

Writes a new block of bytes to the end of a byte array.

HRESULT FillAppend(
  void const *pv,    //Data to be appended to byte array
  ULONG cb,          //Number of bytes to be appended
  ULONG *pcbWritten  //Number of bytes that were successfully 
                     //appended
);
 

Parameters

pv

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

cb

[in] Size of pv in bytes.

pcbWritten

[out] Number of bytes that were successfully written.

Return Values

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

Remarks

The FillAppend method 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 (i.e., 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::ReadAt return any available data or return E_PENDING if data is currently unavailable.

QuickInfo

  Windows NT: Use version 4.0 or later.
  Windows: Use Windows 95 or later.
  Windows CE: Unsupported.
  Header: Declared in objidl.h.

See Also

ILockBytes