Fungsi RtlUpcaseUnicodeStringToCountedOemString (ntifs.h)
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).
Persyaratan
Persyaratan | Nilai |
---|---|
Target Platform | Universal |
Header | ntifs.h (termasuk Ntifs.h) |
Pustaka | NtosKrnl.lib |
DLL | NtosKrnl.exe |
IRQL | < DISPATCH_LEVEL |
Lihat juga
RtlOemStringToCountedUnicodeString
RtlUnicodeStringToCountedOemString