Fungsi RtlUpcaseUnicodeStringToCountedOemString (ntifs.h)

Artikel
02/29/2024

Rutinitas RtlUpcaseUnicodeStringToCountedOemString menerjemahkan string sumber Unicode tertentu ke dalam string OEM yang dihitung huruf besar menggunakan halaman kode OEM sistem saat ini.

Sintaks

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToCountedOemString(
       POEM_STRING      DestinationString,
  [in] PCUNICODE_STRING SourceString,
  [in] BOOLEAN          AllocateDestinationString
);

Parameter

DestinationString

Arahkan ke buffer yang dialokasikan penelepon untuk menerima string OEM yang dihitung. Jika AllocateDestinationString false, pemanggil juga harus mengalokasikan buffer untuk anggota BufferDestinationString untuk menyimpan data OEM. Jika AllocateDestinationString TRUE, RtlUpcaseUnicodeStringToCountedOemString mengalokasikan buffer yang cukup besar untuk menahan string, meneruskan penunjuk ke dalamnya di Buffer, dan memperbarui panjang dan panjang maksimum anggota DestinationString yang sesuai.

[in] SourceString

Penunjuk ke string Unicode yang akan diterjemahkan.

[in] AllocateDestinationString

Atur ke TRUE jika RtlUpcaseUnicodeStringToCountedOemString harus mengalokasikan ruang buffer untuk DestinationString, false jika tidak. Jika parameter ini TRUE, pemanggil bertanggung jawab untuk membebaskan buffer ketika tidak lagi diperlukan dengan memanggil RtlFreeOemString.

Nilai kembali

RtlUpcaseUnicodeStringToCountedOemString mengembalikan STATUS_SUCCESS jika mengembalikan string yang diterjemahkan di DestinationString. Jika tidak, tidak ada penyimpanan yang dialokasikan, atau konversi apa pun yang dilakukan. Ini mengembalikan STATUS_UNMAPPABLE_CHARACTER jika tidak dapat menerjemahkan karakter di SourceString yang diberikan.

Keterangan

RtlUpcaseUnicodeStringToCountedOemString mengembalikan string yang tidak dihentikan null. Ini menerjemahkan string sumber yang diberikan menggunakan halaman kode OEM yang diinstal sebagai halaman kode sistem saat ini pada waktu boot sistem, dan mengonversi string yang diterjemahkan menjadi huruf besar.

Untuk menemukan pemetaan yang paling cocok untuk karakter khusus apa pun, seperti karakter hak cipta, dalam string sumber tertentu, RtlUpcaseUnicodeStringToCountedOemString melakukan operasi berikut:

Menerjemahkan salinan string Unicode di SourceString ke dalam string OEM
Menerjemahkan string OEM kembali ke Unicode
Mengonversi string Unicode baru ini menjadi huruf besar
Menerjemahkan string Unicode huruf besar ke dalam string OEM yang dihitung dan mengembalikannya di DestinationString

Rutinitas ini tidak mengubah string sumber.

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