WindowsGetStringRawBuffer 函数 (winstring.h)

检索指定字符串的后盾缓冲区。

Syntax

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

参数

string

类型:[in,可选] HSTRING

要为其检索支持缓冲区的可选字符串。 可以为 NULL

length

类型:[out, optional] UINT32 *

指向 UINT32 的可选指针。 如果为长度传递 NULL则忽略它。 如果 length指向 UINT32 的有效指针,并且字符串是有效的 HSTRING,则在成功完成后,函数会将长度指向字符串后盾缓冲区中的 Unicode 字符数(包括嵌入的 null 字符,但不包括终止 null)。 如果 length指向 UINT32 的有效指针,并且 字符串NULL则长度指向 的值设置为 0。

返回值

类型:PCWSTR

指向为 字符串提供后盾存储的缓冲区的指针;如果 字符串NULL 或空字符串,则为空字符串。

注解

使用 WindowsGetStringRawBuffer 函数获取指向 HSTRING 后盾缓冲区的指针。

不要更改缓冲区的内容 - HSTRING 需要不可变。

要求

Requirement 价值
最低支持的客户端 Windows 8 [桌面应用 |UWP 应用]
支持的最低服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows操作系统
Header winstring.h
Library mincore.lib