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

Статья
08/07/2023

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

Синтаксис

NTSYSAPI NTSTATUS RtlMultiByteToUnicodeN(
  [out]           PWCH       UnicodeString,
  [in]            ULONG      MaxBytesInUnicodeString,
  [out, optional] PULONG     BytesInUnicodeString,
  [in]            const CHAR *MultiByteString,
  [in]            ULONG      BytesInMultiByteString
);

Параметры

[out] UnicodeString

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

[in] MaxBytesInUnicodeString

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

[out, optional] BytesInUnicodeString

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

[in] MultiByteString

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

[in] BytesInMultiByteString

Размер строки в байтах в MultiByteString.

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

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

RtlMultiByteToUnicodeN поддерживает только предварительно скомпилированные символы Юникода, сопоставленные с текущей системной кодовой страницей ANSI, установленной при загрузке системы.

Хотя BytesInUnicodeString является необязательным и может иметь значение NULL, вызывающие стороны должны предоставить для него хранилище, так как полученную длину можно использовать для определения успешности преобразования.

Если текущая системная кодовая страница определяет однобайтовый набор символов, все символы ANSI в диапазоне 0x00 0x7f просто расширяются нулем в соответствующей строке Юникода для ускорения операции преобразования. Значение ANSI, 0x5c на такой кодовой странице, преобразуется в символ обратной косой черты, даже если текущая однобайтовая кодовая страница определяет этот символ как знак иены.

RtlMultiByteToUnicodeN не изменяет исходную строку, если указатели UnicodeString и MultiByteString не являются эквивалентными. Возвращаемая строка Юникода не заканчивается null.

Как и RtlMultiByteToUnicodeSize, RtlMultiByteToUnicodeN поддерживает только предварительно скомпилированные символы Юникода, которые сопоставлены с текущей системной кодовой страницей ANSI, установленной при загрузке системы.

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

Требования

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

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

RtlMultiByteToUnicodeSize

RtlUnicodeToMultiByteN

Share via