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


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

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

Синтаксис

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

Параметры

DestinationString

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

SourceString

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

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

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

Комментарии

Подпрограмма копирует значение указателя SourceString в элемент Bufferструктуры UTF8_STRING , на которую указывает DestinationString. Элементу Length этой структуры присваивается длина исходной строки в байтах, за исключением завершающего значения NULL. Для элемента MaximumLength структуры задается длина исходной строки в байтах, включая завершающее значение NULL. Если параметр SourceString имеет значение NULL, то значения Length и MaximumLength равны нулю.

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

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

Требования

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

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

RtlInitAnsiString