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

Статья
02/07/2025

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

Синтаксис

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

Параметры

DestinationString

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

[in] SourceString

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

[in] AllocateDestinationString

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

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

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

Замечания

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

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

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

Требования

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