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

Статья
03/13/2024

Преобразует указанную исходную строку Юникода в строку OEM. Перевод выполняется в отношении кодовой страницы OEM (OCP).

Синтаксис

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

Параметры

[out] DestinationString

Указатель на структуру OEM_STRING , содержащую oem-эквивалент исходной строки Юникода. Поле MaximumLength задается, если свойство AllocateDestinationString имеет значение TRUE.

[in] SourceString

Указатель на структуру UNICODE_STRING , которая должна быть преобразована в oem.

[in] AllocateDestinationString

Управляет выделением буферного пространства для строки назначения.

TRUE

Буферное пространство выделяется для DestinationString. Если задано значение TRUE, буфер должен быть освобожден с помощью RtlFreeOemString.

Ложь.

Буферное пространство не выделяется для DestinationString.

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

Различные значения NTSTATUS определяются в NTSTATUS. H, который распространяется с DDK Windows.

Код возврата	Описание
STATUS_SUCCESS	Строка Юникода была преобразована в OEM. В противном случае хранилище не выделено, а преобразование не выполнялось.

Требования

Требование	Значение
Минимальная версия клиента	Windows 2000 Professional [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	winternl.h
Библиотека	ntdll.lib
DLL	ntdll.dll

Поделиться через