Fungsi RtlMultiByteToUnicodeSize (ntifs.h)
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 |