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

Статья
02/07/2025

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

Синтаксис

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

Параметры

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

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

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

Замечания

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

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

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

Требования

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