Fungsi SetFileApisToANSI (fileapi.h)

Artikel
08/23/2023

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

Sintaks

void SetFileApisToANSI();

Mengembalikan nilai

Tidak ada

Keterangan

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

Fungsi SetFileApisToANSI melengkapi fungsi SetFileApisToOEM , yang menyebabkan set fungsi I/O file yang sama menggunakan halaman kode kumpulan karakter OEM.

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 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. Menghambat solusi tersebut, aplikasi konsol dapat memanggil fungsi SetFileApisToOEM untuk menyebabkan serangkaian 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 Berbagi File Peluasan Skala (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