RtlMultiByteToUnicodeN 函数 （ntifs.h）
RtlMultiByteToUnicodeN 例程使用当前系统 ANSI 代码页（ACP）将指定的源字符串转换为 Unicode 字符串。 源字符串不一定来自多字节字符集。
语法
NTSYSAPI NTSTATUS RtlMultiByteToUnicodeN(
[out] PWCH UnicodeString,
[in] ULONG MaxBytesInUnicodeString,
[out, optional] PULONG BytesInUnicodeString,
[in] const CHAR *MultiByteString,
[in] ULONG BytesInMultiByteString
);
参数
[out] UnicodeString
指向接收已转换字符串的调用方分配的缓冲区的指针。 UnicodeString 缓冲区不得与 MultiByteString 缓冲区重叠。
[in] MaxBytesInUnicodeString
要以 UnicodeString写入的最大字节数。 如果此值导致转换后的字符串被截断，RtlMultiByteToUnicodeN 不会返回错误状态。
[out, optional] BytesInUnicodeString
指向调用方分配的变量的指针，该变量接收已转换字符串的长度（以字节为单位）。 此参数可以 NULL。
[in] MultiByteString
指向要翻译的字符串的指针。
[in] BytesInMultiByteString
MultiByteString处字符串的大小（以字节为单位）。
返回值
RtlMultiByteToUnicodeN 返回STATUS_SUCCESS。
言论
RtlMultiByteToUnicodeN 仅支持映射到系统启动时安装的当前系统 ANSI 代码页的预编译 Unicode 字符。
尽管 BytesInUnicodeString 是可选的，并且可以 NULL，但调用方应为其提供存储，因为接收的长度可用于确定转换是否成功。
如果当前系统代码页定义了单字节字符集，则范围中的所有 ANSI 字符0x00到0x7f只是在相应的 Unicode 字符串中以零扩展，以加快转换作的速度。 此类代码页中的 ANSI 值0x5c转换为反斜杠字符，即使当前单字节代码页将此字符定义为日元符号也是如此。
RtlMultiByteToUnicodeN 不会修改源字符串，除非 UnicodeString 和 MultiByteString 指针是等效的。 返回的 Unicode 字符串不以 null 结尾。
与 RtlMultiByteToUnicodeSize一样，RtlMultiByteToUnicodeN 仅支持映射到系统启动时安装的当前系统 ANSI 代码页的预编译 Unicode 字符。
有关其他字符串处理例程的信息，请参阅 Run-Time Library （RTL） 例程。
要求
| 要求 | 价值 |
|---|---|
| 目标平台 | 普遍 |
| 标头 | ntifs.h （include Ntifs.h） |
| 库 | NtosKrnl.lib |
| DLL | NtosKrnl.exe（内核模式）：Ntdll.dll（用户模式） |
| IRQL | < DISPATCH_LEVEL |