Функция RtlUpcaseUnicodeToMultiByteN (ntifs.h)
Подпрограмма RtlUpcaseUnicodeToMultiByteN преобразует указанную строку Юникода в новую строку символов в верхнем регистре, используя текущую кодовую страницу ANSI (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 не вызвал усечение.
Дополнительные сведения о других подпрограммах обработки строк см. в Run-Time подпрограммах библиотеки (RTL).
Требования
| Требование | Ценность |
|---|---|
| целевая платформа | Всеобщий |
| заголовка | ntifs.h (include Ntifs.h) |
| библиотеки | NtosKrnl.lib |
| DLL | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |