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

Подпрограмма RtlUnicodeToOemN преобразует заданную строку Юникода в строку OEM, используя текущую системную кодовую страницу OEM.

Синтаксис

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Параметры

[out] OemString

Указатель на буфер, выделенный вызывающим объектом, для получения переведенной строки.

[in] MaxBytesInOemString

Максимальное число байтов, записываемых в OemString.

[out, optional] BytesInOemString

Указатель на переменную, выделенную вызывающим объектом, которая получает количество байтов в переведенной строке. Этот параметр может принимать значение NULL.

[in] UnicodeString

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

[in] BytesInUnicodeString

Размер строки в ЮникодСтроинге в байтах.

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

Функция RtlUnicodeToOemN возвращает STATUS_SUCCESS, если полная строка в UnicodeString была переведена и возвращена в OemString.

Комментарии

Для возвращаемого значения STATUS_BUFFER_OVERFLOW усеченная строка в OemString была переведена без ошибок.

Для возвращаемого значения STATUS_SUCCESS значение BytesInOemString , если оно имеется, указывает длину возвращаемой строки, а не заданную строку MaxBytesInOemString.

RtlUnicodeToOemN не изменяет исходную строку. Он возвращает строку OEM, завершающуюся значением NULL, если заданный объект BytesInUnicodeString содержал признак конца NULL и если заданное значение MaxBytesInOemString не привело к усечению.

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

Требования

См. также раздел

RtlOemToUnicodeN

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemString