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

Статья
02/29/2024

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

Синтаксис

NTSYSAPI NTSTATUS RtlUnicodeStringToUTF8String(
  PUTF8_STRING     DestinationString,
  PCUNICODE_STRING SourceString,
  BOOLEAN          AllocateDestinationString
);

Параметры

DestinationString

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

SourceString

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

AllocateDestinationString

Значение TRUE , если эта подпрограмма выделяет буферное пространство для DestinationString. Если это так, буфер должен быть освобожден путем вызова RtlFreeUTF8String.

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

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

Требования

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

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

RtlFreeUTF8String

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