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 |