通过

WindowsDeleteStringBuffer 函数 (winstring.h)

  • 项目

如果预先分配的字符串缓冲区未提升为 HSTRING，则放弃该缓冲区。

语法

HRESULT WindowsDeleteStringBuffer(
  HSTRING_BUFFER bufferHandle
);

参数

bufferHandle

类型：[in] HSTRING_BUFFER

要丢弃的缓冲区。 如果调用 WindowsPreallocateStringBuffer 函数未分配 bufferHandle，WindowsDeleteStringBuffer 函数将引发异常。

返回值

类型： HRESULT

此函数可以返回其中一个值。

返回代码 说明
S_OK
 缓冲区已成功丢弃。
E_POINTER
 bufferHandle 为 NULL。

注解

使用 WindowsDeleteStringBuffer 函数放弃由 WindowsPreallocateStringBuffer 函数创建但尚未由 WindowsPromoteStringBuffer 函数提升为 HSTRING 的字符串缓冲区。

注意未定义在使用相同的缓冲区句柄调用 WindowsDeleteStringBuffer 后调用 WindowsPromoteStringBuffer。
 

示例

下面的代码示例演示如何使用 WindowsDeleteStringBuffer 函数。

int main()
{
    HSTRING_BUFFER hStringBuffer = NULL;
    PWSTR strBuffer = NULL;
    HRESULT hr = WindowsPreallocateStringBuffer(10, &strBuffer, &hStringBuffer);

    // You hit a case in which you need to discard the buffer.

    WindowsStringDeleteBuffer(hStringBuffer);
}

要求

要求 值
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 winstring.h
Library RuntimeObject.lib
DLL ComBase.dll

另请参阅

HSTRING

HSTRING_BUFFER

WindowsPreallocateStringBuffer

WindowsPromoteStringBuffer