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

Статья
02/29/2024

Подпрограмма RtlUpcaseUnicodeStringToOemString преобразует заданную исходную строку Юникода в строку OEM в верхнем регистре с помощью текущей системной кодовой страницы OEM.

Синтаксис

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Параметры

DestinationString

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

[in] SourceString

Указатель на строку Юникода для перевода.

[in] AllocateDestinationString

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

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

RtlUpcaseUnicodeStringToOemString возвращает STATUS_SUCCESS при преобразовании строки в DestinationString . В противном случае хранилище не было выделено, и преобразование не выполнялось.

RtlUpcaseUnicodeStringToOemString преобразует заданную исходную строку с помощью кодовой страницы OEM, которая была установлена в качестве текущей системной кодовой страницы во время загрузки системы, и преобразует строку OEM в верхний регистр.

Эта подпрограмма может заменить символ по умолчанию в конечной строке для всех символов исходной строки, которые она не может сопоставить с текущей кодовой страницей, а затем вернуть STATUS_SUCCESS.

Эта подпрограмма не изменяет исходную строку. Он возвращает строку OEM, завершаемую null.

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

Требования

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