WindowsGetStringRawBuffer 函数 (winstring.h)

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

语法

PCWSTR WindowsGetStringRawBuffer(
  HSTRING string,
  UINT32  *length
);

参数

string

类型:[in,可选] HSTRING

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

length

类型:[out,可选] UINT32 *

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

返回值

类型: PCWSTR

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

注解

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

请勿更改缓冲区的内容 - HSTRING 必须不可变。

要求

   
最低受支持的客户端 Windows 8 [桌面应用 |UWP 应用]
最低受支持的服务器 Windows Server 2012 [桌面应用 |UWP 应用]
目标平台 Windows
标头 winstring.h