Fungsi RtlUpcaseUnicodeStringToOemString (ntifs.h)

Artikel
02/26/2024

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

Sintaks

NTSYSAPI NTSTATUS RtlUpcaseUnicodeStringToOemString(
       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 AllocateDestinationStringFALSE, pemanggil juga harus mengalokasikan buffer untuk anggota BufferDestinationString untuk menyimpan data OEM. Jika AllocateDestinationStringTRUE, RtlUpcaseUnicodeStringToOemString mengalokasikan buffer yang cukup besar untuk menahan string, meneruskan penunjuk ke dalam Buffer, dan memperbarui panjang dan panjang maksimum anggota DestinationString yang sesuai.

[in] SourceString

Arahkan ke string Unicode yang akan diterjemahkan.

[in] AllocateDestinationString

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

Nilai kembali

RtlUpcaseUnicodeStringToOemString mengembalikan STATUS_SUCCESS jika string di DestinationString diterjemahkan. Jika tidak, tidak ada penyimpanan yang dialokasikan, juga tidak ada konversi yang dilakukan.

Keterangan

RtlUpcaseUnicodeStringToOemString menerjemahkan string sumber yang diberikan menggunakan halaman kode OEM yang diinstal sebagai halaman kode sistem saat ini pada waktu boot sistem, dan mengonversi string OEM menjadi huruf besar.

Rutinitas ini dapat mengganti karakter default dalam string tujuan untuk semua karakter string sumber yang tidak dapat dipetakan ke halaman kode saat ini lalu mengembalikan STATUS_SUCCESS.

Rutinitas ini tidak mengubah string sumber. Ini mengembalikan string OEM yang dihentikan null.

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