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。

有关其他字符串处理例程的信息，请参阅 Run-Time Library (RTL) 例程中的字符串操作函数。

要求

要求 值
最低受支持的客户端 Windows 2000
目标平台 通用
标头 ntifs.h (包括 Ntifs.h)
Library NtosKrnl.lib
DLL NtosKrnl.exe (内核模式) ;Ntdll.dll (用户模式)
IRQL PASSIVE_LEVEL

另请参阅

RtlFreeUnicodeString

UNICODE_STRING