Fungsi RtlUpcaseUnicodeToMultiByteN (ntifs.h)

Artikel
02/29/2024

Rutinitas RtlUpcaseUnicodeToMultiByteN menerjemahkan string Unicode yang ditentukan ke dalam string karakter huruf besar baru, menggunakan halaman kode ANSI sistem saat ini (ACP). String yang diterjemahkan belum tentu dari set karakter multibyte.

Sintaks

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToMultiByteN(
  [out]           PCHAR  MultiByteString,
  [in]            ULONG  MaxBytesInMultiByteString,
  [out, optional] PULONG BytesInMultiByteString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parameter

[out] MultiByteString

Arahkan ke buffer yang dialokasikan pemanggil untuk menerima string yang diterjemahkan.

[in] MaxBytesInMultiByteString

Jumlah maksimum byte yang akan ditulis di MultiByteString. Jika nilai ini menyebabkan string yang diterjemahkan terpotong, RtlUpcaseUnicodeToMultiByteN tidak mengembalikan status kesalahan.

[out, optional] BytesInMultiByteString

Penunjuk ke variabel yang dialokasikan pemanggil yang menerima panjang, dalam byte, dari string yang diterjemahkan. Parameter ini bisa NULL.

[in] UnicodeString

Arahkan ke string sumber Unicode yang akan diterjemahkan.

[in] BytesInUnicodeString

Ukuran, dalam byte, dari string di UnicodeString.

Nilai kembali

RtlUpcaseUnicodeToMultiByteN mengembalikan STATUS_SUCCESS.

Keterangan

RtlUpcaseUnicodeToMultiByteN menerjemahkan string Unicode yang diberikan menggunakan halaman kode ANSI sistem saat ini yang diinstal pada waktu boot sistem dan mengonversi string yang diterjemahkan menjadi huruf besar.

Rutinitas ini tidak mengubah string sumber. Ini mengembalikan string ANSI yang dihentikan NULL jika BytesInUnicodeString yang diberikan menyertakan terminator NULL dan jika MaxBytesInMultiByteString yang diberikan tidak menyebabkan pemotongan.

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