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

Статья
02/07/2025

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

Синтаксис

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

Параметры

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

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

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

Замечания

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

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

Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).

Требования

Требование	Ценность
целевая платформа	Всеобщий
заголовка	ntifs.h (include Ntifs.h)
библиотеки	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	< DISPATCH_LEVEL

См. также

RtlFreeUnicodeString

RtlUpcaseUnicodeString

UNICODE_STRING

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