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

Статья
02/07/2025

RtlInitUTF8StringEx инициализирует подсчитанная строка символов UTF-8.

Синтаксис

NTSYSAPI NTSTATUS RtlInitUTF8StringEx(
  PUTF8_STRING          DestinationString,
  __drv_aliasesMem PCSZ SourceString
);

Параметры

DestinationString

Указатель на инициализацию UTF8_STRING структуры. Файл заголовка ntdef.h определяет эту структуру, идентичную структуре ANSI_STRING.

SourceString

Указатель на строку символов, завершаемую значением NULL. SourceString используется для инициализации подсчетной строки, на которую DestinationString.

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

RtlInitUTF8StringEx возвращает STATUS_NAME_TOO_LONG, если SourceString слишком длинный. В противном случае эта подпрограмма возвращает STATUS_SUCCESS.

Замечания

RtlInitUTF8StringEx задает элементы структуры UTF8_STRING, которая DestinationString указывает следующим образом:

Копирует значение указателя SourceString в элемент буфера.
Задает элемент length длину (в байтах) исходной строки, за исключением конца null.
Задает элемент MaximumLength длину в байтах исходной строки, включая завершающий значение NULL.

Если SourceStringNULL, длина и MaximumLength имеют значение нулю.

RtlInitStringEx не изменяет исходную строку, указанную SourceString.

Вызывающие RtlInitStringEx могут выполняться в IRQL <= DISPATCH_LEVEL, если буфер DestinationString недоступен. Как правило, вызывающие пользователи выполняются в IRQL = PASSIVE_LEVEL, так как большинство других RtlXxxстроковые подпрограммы не могут вызываться в IRQL > PASSIVE_LEVEL.

Требования

Требование	Ценность
минимальные поддерживаемые клиентские	Windows 10 версии 2004
заголовка	ntifs.h

См. также

ANSI_STRING

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