Share via

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

  • Статья

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 в элемент Buffer .

  • Задает для элемента Length длину исходной строки в байтах, за исключением завершающего значения NULL.

  • Задает для члена MaximumLength длину исходной строки в байтах, включая завершающее значение NULL.

Если параметр SourceString имеет значение NULL, то значения Length и MaximumLength равны нулю.

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

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

Требования

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

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

ANSI_STRING