Функция RtlInitStringEx (ntifs.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 > .

Требования

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

ANSI_STRING