Fungsi RtlUnicodeStringToOemString (ntifs.h)

Artikel
02/26/2024

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

Sintaks

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

Parameter

DestinationString

Arahkan ke buffer yang dialokasikan penelepon untuk menerima string OEM. Jika AllocateDestinationStringFALSE, pemanggil juga harus mengalokasikan buffer untuk anggota BufferDestinationString untuk menyimpan data OEM. Jika AllocateDestinationStringTRUE, RtlUnicodeStringToOemString 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 RtlUnicodeStringToOemString 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

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

Keterangan

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

RtlUnicodeStringToOemString tidak mengubah string sumber. Ini mengembalikan string OEM yang dihentikan null.

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