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