Функция RtlCreateUnicodeString (ntifs.h)

Подпрограмма RtlCreateUnicodeString создает новую подсчитываемую строку Юникода.

Синтаксис

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

Параметры

[out] DestinationString

Указатель на только что выделенную и инициализированную строку Юникода.

[in] SourceString

Указатель на строку Юникода, завершающую значение NULL, с которой инициализировать новую строку.

Возвращаемое значение

RtlCreateUnicodeString возвращает TRUE, если строка Юникода была успешно создана, FALSE в противном случае.

Замечания

DestinationString выделяется из пула страниц. Вызывающий объект отвечает за освобождение DestinationString путем вызова RtlFreeUnicodeString.

Дополнительные сведения о других подпрограммах обработки строк см. в функциях обработки строк в подпрограммах библиотеки Run-Time (RTL).

Требования

Требование Ценность
минимальные поддерживаемые клиентские Windows 2000
целевая платформа Всеобщий
заголовка ntifs.h (include Ntifs.h)
библиотеки NtosKrnl.lib
DLL NtosKrnl.exe (режим ядра); Ntdll.dll (режим пользователя)
IRQL PASSIVE_LEVEL

См. также

RtlFreeUnicodeString

UNICODE_STRING