RtlUTF8StringToUnicodeString 函数 (wdm.h)

  • 项目

RtlUTF8StringToUnicodeString 函数根据当前系统区域设置信息将指定的 UTF8 源字符串转换为 Unicode 字符串。

语法

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

参数

DestinationString

指向 UNICODE_STRING 结构的指针，用于保存转换后的 Unicode 字符串。

如果 AllocateDestinationString 为 TRUE，则例程分配一个新缓冲区来保存字符串数据，更新 DestinationString 的 Buffer 成员以指向新缓冲区，并设置最大长度字段。 否则，例程使用当前指定的缓冲区来保存字符串。

SourceString

指向要转换为 Unicode 的 UTF8 字符串的指针。

AllocateDestinationString

指定此例程是否应为目标字符串分配缓冲区空间。 如果存在，调用方必须通过调用 RtlFreeUnicodeString 解除分配缓冲区。

返回值

如果转换成功， RtlUTF8StringToUnicodeString 将返回STATUS_SUCCESS。 失败时，例程不会分配内存或执行转换。

要求

要求 值
最低受支持的客户端 Windows 10 版本 2004
标头 wdm.h
IRQL PASSIVE_LEVEL

另请参阅

RtlFreeUnicodeString