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

  • Статья

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

Синтаксис

NTSYSAPI NTSTATUS RtlInitStringEx(
  [out]          PSTRING               DestinationString,
  [in, optional] __drv_aliasesMem PCSZ SourceString
);

Параметры

[out] DestinationString

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

[in, optional] SourceString

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

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

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

Комментарии

Эта подпрограмма инициализирует строку со счетчиком символов.

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

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

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

Требования

Требование Значение
Минимальная версия клиента Доступно начиная с Windows 10.
Целевая платформа Универсальное
Верхняя часть wdm.h (включая Wdm.h, Ntddk.h, Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL См. раздел "Примечания".

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

ANSI_STRING