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

Подпрограмма RtlUpcaseUnicodeToMultiByteN преобразует указанную строку Юникода в новую строку символов верхнего регистра, используя текущую системную кодовую страницу (ACP). Переведенная строка не обязательно является многобайтовой кодировкой.

Синтаксис

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Параметры

[out] MultiByteString

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

[in] MaxBytesInMultiByteString

Максимальное число байтов для записи в MultiByteString. Если это значение приводит к усечению переведенной строки, RtlUpcaseUnicodeToMultiByteN не возвращает состояние ошибки.

[out, optional] BytesInMultiByteString

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

[in] UnicodeString

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

[in] BytesInUnicodeString

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

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

RtlUpcaseUnicodeToMultiByteN возвращает STATUS_SUCCESS.

Комментарии

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

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

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

Требования

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

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteN

RtlUnicodeToMultiByteSize