Share via

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

  • Статья

Подпрограмма RtlDowncaseUnicodeString преобразует указанную исходную строку Юникода в нижний регистр. Перевод соответствует сведениям о текущем языковом стандарте системы.

Синтаксис

NTSYSAPI NTSTATUS RtlDowncaseUnicodeString(
       PUNICODE_STRING  DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Параметры

DestinationString

Указатель на буфер, выделенный вызывающим объектом, для получения преобразованной строки Юникода. Если параметр AllocateDestinationString имеет значение FALSE, вызывающий объект также должен выделить буфер для члена буфераDestinationString для хранения данных Юникода. Если параметру AllocateDestinationString присвоено значение TRUE, RtlDowncaseUnicodeString выделяет буфер, достаточно большой для хранения строки, передает указатель на него в буфере и соответствующим образом обновляет элементы длины и максимальной длины DestinationString .

[in] SourceString

Указатель на исходную строку Юникода, которая будет преобразована в нижний регистр.

[in] AllocateDestinationString

Установите значение TRUE , если RtlDowncaseUnicodeString должен выделить буферное пространство для DestinationString, в противном случае — FALSE . Если этот параметр имеет значение TRUE, вызывающий объект отвечает за освобождение буфера, когда он больше не нужен, вызывая RtlFreeUnicodeString.

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

Если операция выполнена успешно, функция RtlDowncaseUnicodeString возвращает STATUS_SUCCESS. В противном случае хранилище не выделено и преобразование не было выполнено.

Комментарии

Если вызывающий объект присваивает свойству AllocateDestinationString значение TRUE, RtlDowncaseUnicodeString заменяет член буфераDestinationString указателем на буфер, который он выделяет. Старое значение можно перезаписать, даже если подпрограмма возвращает код состояния ошибки.

RtlDowncaseUnicodeString не изменяет исходную строку.

Сведения о других процедурах обработки строк см. в статье Подпрограммы библиотеки времени выполнения (RTL).

Требования

Требование Значение
Целевая платформа Универсальное
Верхняя часть ntifs.h (включая Ntifs.h)
Библиотека NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

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

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING