IByteBuffer::SetSize 方法
[ SetSize 方法可用于“要求”部分中指定的操作系统。 它不适用于 Windows Server 2003 Service Pack 1 (SP1) 及更高版本、Windows Vista、Windows Server 2008 和操作系统的后续版本。 IStream 接口提供类似的功能。]
SetSize 方法更改流对象的大小。
语法
HRESULT SetSize(
[in] LONG libNewSize
);
parameters
-
libNewSize [in]
-
以字节数表示的新流大小
返回值
返回值为 HRESULT。 值为 S_OK 表示调用成功。
备注
IByteBuffer::SetSize 方法更改流对象的大小。 调用此方法可预分配流的空间。 如果 libNewSize 参数大于当前流大小,则通过使用未定义值的字节填充干预空间,将流扩展到指示的大小。 此操作类似于 IByteBuffer::Write 方法(如果查找指针超过当前流结束)。
如果 libNewSize 参数小于当前流,则流将被截断为指示的大小。
搜寻指针不受流大小更改的影响。
调用 IByteBuffer::SetSize 是尝试获取大块连续空间的有效方法。
示例
以下示例演示如何设置缓冲区大小。
LONG lNewSize = 256;
HRESULT hr;
// Change the buffer size.
hr = pIByteBuff->SetSize(lNewSize);
if (FAILED(hr))
printf("Failed IByteBuffer::SetSize\n");
要求
要求 | 值 |
---|---|
最低受支持的客户端 |
Windows XP [仅限桌面应用] |
最低受支持的服务器 |
Windows Server 2003 [仅限桌面应用] |
客户端支持终止 |
Windows XP |
终止服务器支持 |
Windows Server 2003 |
标头 |
|
类型库 |
|
DLL |
|
IID |
IID_IByteBuffer定义为 E126F8FE-A7AF-11D0-B88A-00C04FD424B9 |
反馈
https://aka.ms/ContentUserFeedback。
即将发布:在整个 2024 年,我们将逐步淘汰作为内容反馈机制的“GitHub 问题”,并将其取代为新的反馈系统。 有关详细信息,请参阅:提交和查看相关反馈