Функция RtlUTF8StringToUnicodeString (wdm.h)

Статья
08.08.2023

Функция RtlUTF8StringToUnicodeString преобразует указанную исходную строку UTF8 в строку Юникода в соответствии с текущими сведениями о языковом стандарте системы.

Синтаксис

C++

NTSYSAPI NTSTATUS RtlUTF8StringToUnicodeString(
  PUNICODE_STRING DestinationString,
  PUTF8_STRING    SourceString,
  BOOLEAN         AllocateDestinationString
);

Параметры

DestinationString

Указатель на структуру UNICODE_STRING для хранения преобразованной строки Юникода.

Если параметр AllocateDestinationString имеет значение TRUE, подпрограмма выделяет новый буфер для хранения строковых данных, обновляет элемент Bufferэлемента DestinationString , чтобы он указывал на новый буфер, и задает поле максимальной длины. В противном случае подпрограмма использует указанный в данный момент буфер для хранения строки.

SourceString

Указатель на строку UTF8, которая будет преобразована в Юникод.

AllocateDestinationString

Указывает, должна ли эта подпрограмма выделять буферное пространство для строки назначения. Если это так, вызывающий объект должен освободить буфер, вызвав RtlFreeUnicodeString.

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

Если преобразование выполнено успешно, RtlUTF8StringToUnicodeString возвращает STATUS_SUCCESS. При сбое подпрограмма не выделяет память и не выполняет преобразование.

Требования

Требование	Значение
Минимальная версия клиента	Windows 10 версии 2004
Верхняя часть	wdm.h
IRQL	PASSIVE_LEVEL

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

RtlFreeUnicodeString

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