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