SetFileApisToANSI 関数 (fileapi.h)

ファイル I/O 関数で、現在のプロセスに ANSI 文字セット コード ページを使用させます。 この関数は、8 ビットコンソールの入出力操作に役立ちます。

構文

void SetFileApisToANSI();

戻り値

なし

解説

コード ページが SetFileApisToANSI によって設定されているファイル I/O 関数は、ファイル名を受け入れるか返す KERNEL32.DLL によってエクスポートされる関数です。 SetFileApisToANSI は、スレッドごとまたはコンピューターごとではなく、プロセスごとにコード ページを設定します。

SetFileApisToANSI 関数は SetFileApisToOEM 関数を補完します。これにより、同じファイル I/O 関数のセットで OEM 文字セット コード ページが使用されます。

8 ビット コンソール関数では、既定で OEM コード ページが使用されます。 その他のすべての関数では、既定で ANSI コード ページが使用されます。 つまり、コンソール関数によって返される文字列は、他の関数によって正しく処理されない可能性があり、その逆も同様です。 たとえば、 FindFirstFileA 関数が特定の拡張 ANSI 文字を含む文字列を返し、8 ビット コンソール関数が OEM コード ページを使用するように設定されている場合、 WriteConsoleA 関数は文字列を正しく表示しません。

AreFileApisANSI 関数を使用して、ファイル I/O 関数のセットが現在使用しているコード ページを確認します。 SetConsoleCP 関数と SetConsoleOutputCP 関数を使用して、8 ビット コンソール関数のコード ページを設定します。

コード ページの非互換性の問題を解決するには、コンソール アプリケーションに Unicode を使用することをお勧めします。 Unicode を使用するコンソール アプリケーションは、8 ビット コンソール関数を使用するアプリケーションよりもはるかに汎用性が高くなります。 そのソリューションを除いて、コンソール アプリケーションは SetFileApisToOEM 関数を呼び出して、ファイル I/O 関数のセットで ANSI 文字セット文字列ではなく OEM 文字セット文字列を使用させることができます。 SetFileApisToANSI 関数を使用して、それらの関数を ANSI コード ページに戻します。

コマンド ラインを処理する場合、コンソール アプリケーションは Unicode 形式でコマンド ラインを取得し、関連する文字から OEM 関数を使用して OEM フォームに変換する必要があります。 また、コマンド ライン メイン関数の argv パラメーターの配列には、この場合の ANSI 文字セット文字列が含まれていることに注意してください。

Windows 8 と Windows Server 2012 では、この関数は、次のテクノロジによってサポートされています。

テクノロジ	サポートされています
サーバー メッセージ ブロック (SMB) 3.0 プロトコル	はい
SMB 3.0 Transparent Failover (TFO)	はい
スケールアウト ファイル共有 (SO) を使う SMB 3.0	はい
クラスターの共有ボリューム ファイル システム (CsvFS)	はい
Resilient File System (ReFS)	はい

要件

サポートされている最小のクライアント	Windows XP (デスクトップ アプリのみ)
サポートされている最小のサーバー	Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム	Windows
ヘッダー	fileapi.h (Windows.h、WinBase.h を含む)
Library	Kernel32.lib
[DLL]	Kernel32.dll

関連項目

AreFileApisANSI

File Management 関数

FindFirstFileA

SetConsoleCP

SetConsoleOutputCP

SetFileApisToOEM

WriteConsoleA