Fungsi RtlUnicodeToOemN (ntifs.h)

Rutinitas RtlUnicodeToOemN menerjemahkan string Unicode tertentu ke string OEM, menggunakan halaman kode OEM sistem saat ini.

Sintaks

NTSYSAPI NTSTATUS RtlUnicodeToOemN(
  [out]           PCHAR  OemString,
  [in]            ULONG  MaxBytesInOemString,
  [out, optional] PULONG BytesInOemString,
  [in]            PCWCH  UnicodeString,
  [in]            ULONG  BytesInUnicodeString
);

Parameter

[out] OemString

Arahkan ke buffer yang dialokasikan pemanggil untuk menerima string yang diterjemahkan.

[in] MaxBytesInOemString

Jumlah maksimum byte yang akan ditulis ke OemString.

[out, optional] BytesInOemString

Penunjuk ke variabel yang dialokasikan penelepon yang menerima jumlah byte dalam string yang diterjemahkan. Parameter ini bisa NULL.

[in] UnicodeString

Arahkan ke string sumber Unicode yang akan diterjemahkan.

[in] BytesInUnicodeString

Ukuran, dalam byte, dari string di UnicodeString.

Mengembalikan nilai

RtlUnicodeToOemN mengembalikan STATUS_SUCCESS jika string lengkap di UnicodeString diterjemahkan dan dikembalikan di OemString.

Keterangan

Untuk nilai yang dikembalikan STATUS_BUFFER_OVERFLOW, string yang dipotong di OemString diterjemahkan tanpa kesalahan.

Untuk nilai yang dikembalikan STATUS_SUCCESS, nilai di BytesInOemString, jika ada, menunjukkan panjang string yang dikembalikan, bukan MaxBytesInOemString yang diberikan.

RtlUnicodeToOemN tidak mengubah string sumber. Ini mengembalikan string OEM yang dihentikan null jika BytesInUnicodeString yang diberikan menyertakan terminator NULL dan jika MaxBytesInOemString yang diberikan tidak menyebabkan pemotongan.

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

Persyaratan

   
Target Platform Universal
Header ntifs.h (termasuk Ntifs.h)
Pustaka NtosKrnl.lib
DLL NtosKrnl.exe
IRQL < DISPATCH_LEVEL

Lihat juga

RtlOemToUnicodeN

RtlUnicodeStringToCountedOemString

RtlUnicodeStringToOemString