Функция 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 в элемент буфера элемента структуры STRING, на которую указывает DestinationString. Элемент Length этой структуры имеет длину в байтах исходной строки, за исключением конца null. Элемент MaximumLength структуры имеет длину в байтах исходной строки, включая завершающий значение NULL. Если SourceStringNULL, длина и MaximumLength имеют значение нулю.

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

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

Требования

См. также

ANSI_STRING