Writes a new block of data to a specified location in the byte array.
HRESULT FillAt(
ULARGE_INTEGER uIOffset,
//Offset from beginning of the byte array
void const *pv, //Data to be written
ULONG cb, //Number of bytes to be written
ULONG *pcbWritten
//Number of bytes that were successfully written
);
This function supports the standard return values E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG, and E_FAIL in addition to the following:
The FillAt method is used for nonsequential downloading (for example, http byte range requests). In nonsequential downloading the caller specifies ranges in the byte array where various blocks of data are to be written. Subsequent calls by the compound file implementation to ILockBytes::ReadAt are passed by the byte array wrapper object's own implementation of ILockBytes to the underlying byte array. This method is not currently implemented and will return E_NOTIMPL.
Note The system-supplied IFillLockBytes implementation does not support FillAt and returns E_NOTIMPL.
Windows NT: Use version 4.0 or later.
Windows: Use Windows 95 or later.
Windows CE: Unsupported.
Header: Declared in objidl.h.
IFillLockBytes::FillAppend, IFillLockBytes - Implementation, ILockBytes::ReadAt