Поделиться через

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

  • Статья

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

Синтаксис

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

Параметры

[out] DestinationString

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

[in] SourceString

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

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

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

Комментарии

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

Сведения о других процедурах обработки строк см. в статье Функции обработки строк в статье Подпрограммы библиотеки времени выполнения (RTL).

Требования

Требование Значение
Минимальная версия клиента Windows 2000
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe (режим ядра); Ntdll.dll (пользовательский режим)
IRQL PASSIVE_LEVEL

См. также раздел

RtlFreeUnicodeString

UNICODE_STRING