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

Статья
08/07/2023

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

Синтаксис

NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Параметры

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

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

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

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

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

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

Требования

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