IFillLockBytes::FillAppend 方法 (objidl.h)

FillAppend 方法将新的字节块写入字节数组的末尾。

语法

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

parameters

[in] pv

指向要追加到现有字节数组末尾的数据的指针。 此操作不会造成内存泄漏或缓冲区溢出的危险。

[in] cb

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

[out] pcbWritten

成功写入的字节数。

返回值

此函数支持标准返回值E_OUTOFMEMORY、E_UNEXPECTED、E_INVALIDARG和E_FAIL。

注解

FillAppend 方法用于顺序下载,其中字节按接收顺序写入字节数组的末尾。 此方法获取字节数组的当前大小 (例如 lockbytes 对象) 并将新的数据块写入数组末尾。 当每个数据块变得可用时,下载程序会调用此方法将其写入字节数组。 如果数据当前不可用,则复合文件实现对 ILockBytes::ReadAt 的后续调用将返回任何可用数据或返回E_PENDING。

要求

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

请参阅

ILockBytes