Fungsi RtlMultiByteToUnicodeSize (ntifs.h)

  • Artikel

Rutinitas RtlMultiByteToUnicodeSize menentukan jumlah byte yang diperlukan untuk menyimpan terjemahan Unicode untuk string sumber yang ditentukan. Terjemahan diasumsikan untuk menggunakan halaman kode ANSI sistem saat ini (ACP). String sumber belum tentu dari set karakter multibyte.

Sintaks

NTSYSAPI NTSTATUS RtlMultiByteToUnicodeSize(
  [out] PULONG     BytesInUnicodeString,
  [in]  const CHAR *MultiByteString,
  [in]  ULONG      BytesInMultiByteString
);

Parameter

[out] BytesInUnicodeString

Penunjuk ke variabel yang dialokasikan penelepon yang menerima jumlah byte yang diperlukan untuk menyimpan string yang diterjemahkan.

[in] MultiByteString

Penunjuk ke string sumber tempat panjang Unicode akan dihitung.

[in] BytesInMultiByteString

Panjang, dalam byte, dari string sumber.

Nilai kembali

RtlMultiByteToUnicodeSize mengembalikan STATUS_SUCCESS.

Keterangan

RtlMultiByteToUnicodeSize dapat dipanggil untuk menentukan berapa banyak memori yang akan dialokasikan, atau mungkin, nilai yang akan ditentukan untuk MaxBytesInUnicodeString, sebelum menerjemahkan string multibyte ke Unicode dengan RtlMultiByteToUnicodeN. Nilai yang dikembalikan tidak menyertakan spasi untuk terminator NULL untuk string Unicode.

Seperti RtlMultiByteToUnicodeN, RtlMultiByteToUnicodeSize hanya mendukung karakter Unicode yang telah dikomposisikan sebelumnya yang dipetakan ke halaman kode ANSI sistem saat ini yang diinstal pada boot sistem.

Untuk informasi tentang rutinitas penanganan string lainnya, lihat Rutinitas Pustaka Run-Time (RTL).

Persyaratan

Persyaratan Nilai
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Lihat juga

RtlMultiByteToUnicodeN

RtlUnicodeToMultiByteSize