Fungsi RtlUpcaseUnicodeToOemN (ntifs.h)

Artikel
02/27/2024

Rutinitas RtlUpcaseUnicodeToOemN menerjemahkan string Unicode tertentu ke dalam string OEM huruf besar, menggunakan halaman kode OEM sistem saat ini.

Sintaks

NTSYSAPI NTSTATUS RtlUpcaseUnicodeToOemN(
  [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.

Nilai kembali

RtlUnicodeToOemN mengembalikan STATUS_SUCCESS jika string lengkap di UnicodeString berhasil diterjemahkan, dikonversi ke huruf besar, dan dikembalikan di OemString. Jika tidak, itu dapat mengembalikan STATUS_BUFFER_OVERFLOW jika string tujuan harus dipotong agar sesuai dengan MaxBytesInOemString yang diberikan.

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.

Rutinitas ini 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).