Метод IFillLockBytes::FillAt (objidl.h)

Метод FillAt записывает новый блок данных в указанное расположение в массиве байтов.

Синтаксис

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

Параметры

[in] ulOffset

Смещение, выраженное в количестве байтов, от первого элемента массива байтов.

[in] pv

Указатель на данные для записи в расположении, указанном uIOffset.

[in] cb

Размер пс в байтах.

[out] pcbWritten

Число байтов, которые были успешно записаны.

Возвращаемое значение

Эта функция поддерживает стандартные возвращаемые значения E_OUTOFMEMORY, E_UNEXPECTED, E_INVALIDARG и E_FAIL в дополнение к следующим:

Комментарии

Метод FillAt используется для непоследовательных скачиваний (например, запросов диапазона байтов HTTP). При неокончательном скачивании вызывающий объект задает диапазоны в массиве байтов, в которые необходимо записать различные блоки данных. Последующие вызовы реализации составного файла в ILockBytes::ReadAt передаются собственной реализацией ILockBytes объекта-оболочки массива байтов в базовый массив байтов. Этот метод в настоящее время не реализован и возвращает E_NOTIMPL.

Требования

См. также раздел

IFillLockBytes — реализация

IFillLockBytes::FillAppend

ILockBytes::ReadAt