ILockBytes::SetSize 方法 (objidl.h)

SetSize 方法更改字节数组的大小。

语法

HRESULT SetSize(
  [in] ULARGE_INTEGER cb
);

参数

[in] cb

将字节数组的新大小指定为字节数。

返回值

此方法可以返回其中一个值。

返回代码 说明
S_OK 已成功更改字节数组的大小。
STG_E_ACCESSDENIED 调用方没有访问字节数组的权限。
STG_E_MEDIUMFULL 不会更改字节数组大小,因为存储设备上没有剩余空间。

注解

ILockBytes::SetSize 更改字节数组的大小。 如果 cb 参数大于当前字节数组,则通过用未定义值的字节填充干预空间将字节数组扩展到指示的大小, ILockBytes::WriteAt(如果搜寻指针超过当前流结束)一样。

如果 cb 参数小于当前字节数组,则字节数组将被截断为指示的大小。

给调用方的说明

由于操作系统或网络中的缓存缓冲,调用方不能依赖于在适当时间返回的STG_E_MEDIUMFULL。 但是,调用方必须能够处理此返回代码,因为某些 ILockBytes 实现可能支持它。

要求

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

另请参阅

ILockBytes - File-Based 实现

ILockBytes - 全局内存实现

ILockBytes::ReadAt

ILockBytes::WriteAt