Функция 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).
Требования
| Требование | Значение |
|---|---|
| Целевая платформа | Универсальное |
| Верхняя часть | ntifs.h (включая Ntifs.h) |
| Библиотека | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |