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

Статья
02/07/2025

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

Синтаксис

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

Параметры

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

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

RtlUpcaseUnicodeStringToCountedOemString возвращает STATUS_SUCCESS, если возвращает переведенную строку в DestinationString. В противном случае хранилище не было выделено и не было выполнено никакого преобразования. Он возвращает STATUS_UNMAPPABLE_CHARACTER, если он не может перевести символ в заданной SourceString.

Замечания

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

Чтобы найти лучшее сопоставление для любых специальных символов, таких как символ авторских прав, в данной исходной строке, RtlUpcaseUnicodeStringToCountedOemString выполняет следующие операции:

Преобразует копию строки Юникода в SourceString в строку OEM
Преобразует строку OEM обратно в Юникод
Преобразует эту новую строку Юникода в верхний регистр
Преобразует строку Юникода в подсчитываемую строку OEM и возвращает ее в DestinationString

Эта подпрограмма не изменяет исходную строку.

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

Требования

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