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

OEM_STRING

RtlFreeOemString

RtlOemStringToCountedUnicodeString

RtlUnicodeStringToOemString

RtlUnicodeToOemN

RtlUpcaseUnicodeStringToCountedOemString

UNICODE_STRING