Fungsi RtlUnicodeToMultiByteSize (ntifs.h)

Artikel
02/26/2024

Rutinitas RtlUnicodeToMultiByteSize menentukan jumlah byte yang diperlukan untuk menyimpan terjemahan multibyte untuk string Unicode yang ditentukan. Terjemahan diasumsikan menggunakan halaman kode ANSI sistem saat ini (ACP).

Sintaks

NTSYSAPI NTSTATUS RtlUnicodeToMultiByteSize(
  [out] PULONG BytesInMultiByteString,
  [in]  PCWCH  UnicodeString,
  [in]  ULONG  BytesInUnicodeString
);

Parameter

[out] BytesInMultiByteString

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

[in] UnicodeString

Penunjuk ke string Unicode yang panjangnya multibyte akan dihitung.

[in] BytesInUnicodeString

Panjang, dalam byte, dari string sumber.

Nilai kembali

RtlUnicodeToMultiByteSize mengembalikan STATUS_SUCCESS.

Keterangan

RtlUnicodeToMultiByteSize dapat dipanggil untuk menentukan berapa banyak memori yang akan dialokasikan, atau mungkin nilai yang akan ditentukan untuk MaxBytesInMultiByteString, sebelum menerjemahkan string Unicode ke ANSI dengan RtlUnicodeToMultiByteN atau RtlUpcaseUnicodeToMultiByteN. Nilai yang dikembalikan tidak menyertakan spasi untuk terminator NULL untuk string ANSI.

Seperti RtlUnicodeToMultiByteN, RtlUnicodeToMultiByteSize hanya mendukung karakter Unicode yang telah dipetakan 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).