Fungsi RtlUnicodeStringToCountedOemString (ntifs.h)
Rutinitas RtlUnicodeStringToCountedOemString menerjemahkan string sumber Unicode yang ditentukan ke dalam string OEM yang dihitung menggunakan halaman kode OEM sistem saat ini.
Sintaks
NTSYSAPI NTSTATUS RtlUnicodeStringToCountedOemString(
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, RtlUnicodeStringToCountedOemString 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 Unicode sumber yang akan diterjemahkan.
[in] AllocateDestinationString
Atur ke TRUE jika RtlUnicodeStringToCountedOemString 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
RtlUnicodeStringToCountedOemString mengembalikan STATUS_SUCCESS jika string di DestinationString diterjemahkan. Jika tidak, tidak ada penyimpanan yang dialokasikan, dan tidak ada konversi yang dilakukan. Rutinitas ini mengembalikan STATUS_UNMAPPABLE_CHARACTER jika tidak dapat menerjemahkan karakter dalam SourceString yang diberikan.
Keterangan
RtlUnicodeStringToCountedOemString 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 sistem.
RtlUnicodeStringToCountedOemString 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
RtlOemStringToCountedUnicodeString