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) 例程。

規格需求

需求 值
最低支援的用戶端 Windows 2000
目標平台 Universal
標頭 ntifs.h (包含 Ntifs.h)
程式庫 NtosKrnl.lib
Dll NtosKrnl.exe (核心模式) ;Ntdll.dll (使用者模式)
IRQL PASSIVE_LEVEL

另請參閱

RtlFreeUnicodeString

UNICODE_STRING