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

pv 的大小(以字节为单位)。

[out] pcbWritten

成功写入的字节数。

返回值

除以下各项外,此函数还支持标准返回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL:

返回代码 说明
E_NOTIMPL 字节数组不支持 FillAt 方法。

注解

FillAt 方法用于非连续下载 (例如 HTTP 字节范围请求) 。 在非队列下载中,调用方指定字节数组中要写入各种数据块的范围。 复合文件实现对 ILockBytes::ReadAt 的后续调用将由字节数组包装器对象自己的 ILockBytes 实现传递到基础字节数组。 此方法当前未实现,将返回E_NOTIMPL。

注意 系统提供的 IFillLockBytes 实现不支持 FillAt ,并返回E_NOTIMPL。
 

要求

要求
最低受支持的客户端 Windows 2000 专业版 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows 2000 Server [桌面应用 |UWP 应用]
目标平台 Windows
标头 objidl.h
Library Uuid.lib
DLL Ole32.dll

另请参阅

IFillLockBytes - 实现

IFillLockBytes::FillAppend

ILockBytes::ReadAt