IFillLockBytes::FillAt method

The FillAt method writes a new block of data to a specified location in the byte array.

Syntax


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

Parameters

uIOffset [in]

The offset, expressed in number of bytes, from the first element of the byte array.

pv [in]

Pointer to the data to be written at the location specified by uIOffset.

cb [in]

Size of pv in 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 in addition to the following:

E_NOTIMPL

The byte array does not support the FillAt method.

Remarks

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.
 

Requirements

Minimum supported client

Windows 2000 Professional [desktop apps | Windows Store apps]

Minimum supported server

Windows 2000 Server [desktop apps | Windows Store apps]

Header

Objidl.h

IDL

Objidl.idl

Library

Uuid.lib

DLL

Ole32.dll

IID

IID_IFillLockBytes is defined as 99CAF010-415E-11CF-8814-00AA00B569F5

See also

IFillLockBytes::FillAppend
IFillLockBytes - Implementation
ILockBytes::ReadAt

 

 

Show: