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

另請參閱

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize