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

Статья
08/07/2023

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

Синтаксис

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

Параметры

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

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

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

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

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

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

Требования

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