RtlMultiByteToUnicodeSize 函式 (ntifs.h)
RtlMultiByteToUnicodeSize 例程會決定儲存指定來源字元串 Unicode 轉譯所需的位元元組數目。 翻譯假設使用目前的系統 ANSI 代碼頁， (ACP) 。 來源字串不一定來自多位元組位元集。
語法
NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
[out] PULONG BytesInUnicodeString,
[in] const CHAR *MultiByteString,
[in] ULONG BytesInMultiByteString
);
參數
[out] BytesInUnicodeString
呼叫端配置的變數指標，該變數會接收儲存翻譯字串所需的位元組數目。
[in] MultiByteString
要計算 Unicode 長度的來源字串指標。
[in] BytesInMultiByteString
來源字串的長度，以位元組為單位。
傳回值
RtlMultiByteToUnicodeSize 會傳回STATUS_SUCCESS。
備註
您可以呼叫 RtlMultiByteToUnicodeSize 來判斷要配置多少記憶體，或可能要為 MaxBytesInUnicodeString 指定的值，然後再使用 RtlMultiByteToUnicodeN 將多位元組字元串轉譯成 Unicode。 傳回的值不包含 Unicode 字串之 NULL 終止符的空間。
如同 RtlMultiByteToUnicodeN，RtlMultiByteToUnicodeSize 僅支援對應至系統開機時所安裝之目前系統 ANSI 代碼頁的預先編譯 Unicode 字元。
如需其他字串處理例程的資訊，請參閱 Run-Time Library (RTL) 例程。
規格需求
| 需求 | 值 |
|---|---|
| 目標平台 | Universal |
| 標頭 | ntifs.h (包含 Ntifs.h) |
| 程式庫 | NtosKrnl.lib |
| Dll | NtosKrnl.exe |
| IRQL | < DISPATCH_LEVEL |