RtlCreateUnicodeString 函数 (ntifs.h)

RtlCreateUnicodeString 例程创建一个新的计数 Unicode 字符串。

语法

NTSYSAPI BOOLEAN RtlCreateUnicodeString(
  [out] PUNICODE_STRING DestinationString,
  [in]  PCWSTR          SourceString
);

参数

[out] DestinationString

指向新分配和初始化的 Unicode 字符串的指针。

[in] SourceString

指向用于初始化新字符串的以 null 结尾的 Unicode 字符串的指针。

返回值

如果成功创建 Unicode 字符串,则 RtlCreateUnicodeString 返回 TRUE,否则为 FALSE

注解

DestinationString 是从分页池分配的。 调用方负责通过调用 RtlFreeUnicodeString 释放 DestinationString

有关其他字符串处理例程的信息,请参阅 运行时库 (RTL) 例程中的字符串操作函数。

要求

   
最低受支持的客户端 此例程在 Microsoft Windows 2000 及更高版本上可用。
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL PASSIVE_LEVEL

另请参阅

RtlFreeUnicodeString

UNICODE_STRING