Fungsi RtlOemStringToCountedUnicodeString (ntifs.h)

Artikel
02/26/2024

Rutinitas RtlOemStringToCountedUnicodeString menerjemahkan string sumber yang ditentukan ke dalam string Unicode menggunakan halaman kode OEM sistem saat ini.

Sintaks

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

Parameter

DestinationString

Arahkan ke buffer yang dialokasikan penelepon untuk menerima string Unicode yang diterjemahkan. Jika AllocateDestinationStringfalse, pemanggil juga harus mengalokasikan buffer untuk anggota BufferDestinationString untuk menyimpan data Unicode. Jika AllocateDestinationStringTRUE, RtlOemStringToCountedUnicodeString mengalokasikan buffer yang cukup besar untuk menahan string, meneruskan pointer ke dalamnya di Buffer, dan memperbarui panjang dan panjang maksimum anggota DestinationString yang sesuai.

[in] SourceString

Penunjuk ke string OEM untuk diterjemahkan ke dalam Unicode.

[in] AllocateDestinationString

Atur ke TRUE jika RtlOemStringToCountedUnicodeString 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

Jika operasi berhasil, RtlOemStringToCountedUnicodeString mengembalikan STATUS_SUCCESS. Jika tidak, tidak ada penyimpanan yang dialokasikan dan tidak ada konversi yang dilakukan.

Keterangan

RtlOemStringToCountedUnicodeString mengembalikan string terjemahan yang tidak menyertakan terminator NULL. Ini menerjemahkan string sumber yang diberikan menggunakan halaman kode OEM yang diinstal sebagai halaman kode sistem saat ini pada waktu boot.

RtlOemStringToCountedUnicodeString tidak mengubah string sumber.

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