Fungsi RtlOemStringToUnicodeString (ntifs.h)

Artikel
02/26/2024

Rutinitas RtlOemStringToUnicodeString menerjemahkan string sumber tertentu ke dalam string Unicode yang dihentikan null menggunakan halaman kode OEM sistem saat ini.

Sintaks

NTSYSAPI NTSTATUS RtlOemStringToUnicodeString(
       PUNICODE_STRING DestinationString,
  [in] PCOEM_STRING    SourceString,
  [in] BOOLEAN         AllocateDestinationString
);

Parameter

DestinationString

Penunjuk ke buffer yang dialokasikan penelepon untuk menerima string yang diterjemahkan. Jika AllocateDestinationStringadalah FALSE, pemanggil juga harus mengalokasikan buffer untuk anggota BufferDestinationString untuk menahan string Unicode yang dihentikan null. Jika AllocateDestinationStringTRUE, RtlOemStringToUnicodeString 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

Arahkan ke string OEM untuk diterjemahkan ke Unicode.

[in] AllocateDestinationString

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

Nilai kembali

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

Keterangan

RtlOemStringToUnicodeString menerjemahkan string sumber yang diberikan menggunakan halaman kode OEM yang diinstal sebagai halaman kode sistem saat ini pada waktu boot sistem.

Rutinitas ini tidak mengubah string sumber. Ini mengembalikan string Unicode yang dihentikan NULL.

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