Share via

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

  • Статья

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

Синтаксис

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [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, если конечная строка должна быть усечена, чтобы она соответствовала заданному параметру MaxBytesInOemString.

Комментарии

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

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

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

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

Требования

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

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

RtlUnicodeStringToOemSize

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToCountedOemString

RtlUpcaseUnicodeStringToOemString