共用方式為

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

另請參閱

RtlMultiByteToUnicodeSize

RtlUnicodeToMultiByteN

RtlUpcaseUnicodeToMultiByteN