Fungsi SetFileApisToOEM (fileapi.h)

Artikel
08/23/2023

Menyebabkan fungsi I/O file untuk proses menggunakan halaman kode set karakter OEM. Fungsi ini berguna untuk operasi input dan output konsol 8-bit.

Sintaks

void SetFileApisToOEM();

Mengembalikan nilai

Tidak ada

Keterangan

Fungsi I/O file yang halaman kodenya diatur oleh SetFileApisToOEM adalah fungsi yang diekspor oleh KERNEL32.DLL yang menerima atau mengembalikan nama file. SetFileApisToOEM mengatur halaman kode per proses, bukan per utas atau per komputer.

Fungsi SetFileApisToOEM dilengkapi dengan fungsi SetFileApisToANSI , yang menyebabkan set fungsi I/O file yang sama menggunakan halaman kode kumpulan karakter ANSI.

Fungsi konsol 8-bit menggunakan halaman kode OEM secara default. Semua fungsi lain menggunakan halaman kode ANSI secara default. Ini berarti bahwa string yang dikembalikan oleh fungsi konsol mungkin tidak diproses dengan benar oleh fungsi lain, dan sebaliknya. Misalnya, jika fungsi FindFirstFileA mengembalikan string yang berisi karakter ANSI tertentu yang diperluas, dan fungsi konsol 8-bit diatur untuk menggunakan halaman kode OEM, maka fungsi WriteConsoleA tidak akan menampilkan string dengan benar.

Gunakan fungsi AreFileApisANSI untuk menentukan halaman kode mana yang saat ini digunakan oleh kumpulan fungsi I/O file. Gunakan fungsi SetConsoleCP dan SetConsoleOutputCP untuk mengatur halaman kode untuk fungsi konsol 8-bit.

Untuk mengatasi masalah ketidakcocokan halaman kode, yang terbaik adalah menggunakan Unicode untuk aplikasi konsol. Aplikasi konsol yang menggunakan Unicode jauh lebih serbaguna daripada yang menggunakan fungsi konsol 8-bit. Menghalangi solusi itu, aplikasi konsol dapat memanggil fungsi SetFileApisToOEM untuk menyebabkan kumpulan fungsi I/O file menggunakan string set karakter OEM daripada string set karakter ANSI. Gunakan fungsi SetFileApisToANSI untuk mengatur fungsi tersebut kembali ke halaman kode ANSI.

Saat berhadapan dengan baris perintah, aplikasi konsol harus mendapatkan baris perintah dalam bentuk Unicode dan kemudian mengonversinya ke formulir OEM menggunakan fungsi karakter-ke-OEM yang relevan. Perhatikan juga bahwa array dalam parameter argv dari fungsi utama baris perintah berisi string set karakter ANSI dalam kasus ini.

Di Windows 8 dan Windows Server 2012, fungsi ini didukung oleh teknologi berikut.

Teknologi	Didukung
Protokol Server Message Block (SMB) 3.0	Ya
SMB 3.0 Transparent Failover (TFO)	Ya
SMB 3.0 dengan Scale-out File Shares (SO)	Ya
Sistem File Volume Bersama Kluster (CsvFS)	Ya
Sistem File Tangguh (ReFS)	Ya

Persyaratan


Klien minimum yang didukung	Windows XP [hanya aplikasi desktop]
Server minimum yang didukung	Windows Server 2003 [hanya aplikasi desktop]
Target Platform	Windows
Header	fileapi.h (termasuk Windows.h, WinBase.h)
Pustaka	Kernel32.lib
DLL	Kernel32.dll