RtlUpcaseUnicodeToMultiByteN 函式 (ntifs.h)
RtlUpcaseUnicodeToMultiByteN 例程會使用目前的系統 ANSI 代碼頁，將指定的 Unicode 字串轉譯成新的大寫字元字串， (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
要翻譯之 Unicode 來源字串的指標。
[in] BytesInUnicodeString
在 UnicodeString 的字串大小，以位元組為單位。
傳回值
RtlUpcaseUnicodeToMultiByteN 會傳回STATUS_SUCCESS。
備註
RtlUpcaseUnicodeToMultiByteN 會使用在系統開機時間安裝的目前系統 ANSI 代碼頁來轉譯指定的 Unicode 字符串，並將翻譯的字元串轉換為大寫。
這個例程不會修改來源字串。 如果指定的 BytesInUnicodeString 包含 NULL 終止符，而且指定的 MaxBytesInMultiByteString 未造成截斷，它會傳回 NULL 終止的 ANSI 字符串。
如需其他字串處理例程的資訊，請參閱 Run-Time Library (RTL) 例程。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |