SetFileApisToOEM-Funktion (fileapi.h)

Artikel
08/23/2023

Bewirkt, dass die Datei-E/A-Funktionen für den Prozess die OEM-Zeichensatzcodepage verwenden. Diese Funktion ist für Eingabe- und Ausgabevorgänge der 8-Bit-Konsole nützlich.

Syntax

void SetFileApisToOEM();

Rückgabewert

Keine

Bemerkungen

Die Datei-E/A-Funktionen, deren Codepage von SetFileApisToOEM festgelegt wird, sind die von KERNEL32.DLL exportierten Funktionen, die einen Dateinamen akzeptieren oder zurückgeben. SetFileApisToOEM legt die Codepage pro Prozess und nicht pro Thread oder Computer fest.

Die SetFileApisToOEM-Funktion wird durch die SetFileApisToANSI-Funktion ergänzt, die dazu führt, dass derselbe Satz von Datei-E/A-Funktionen die ANSI-Zeichensatzcodepage verwendet.

Die 8-Bit-Konsolenfunktionen verwenden standardmäßig die OEM-Codepage. Alle anderen Funktionen verwenden standardmäßig die ANSI-Codepage. Dies bedeutet, dass von den Konsolenfunktionen zurückgegebene Zeichenfolgen möglicherweise nicht ordnungsgemäß von anderen Funktionen verarbeitet werden und umgekehrt. Wenn die FindFirstFileA-Funktion beispielsweise eine Zeichenfolge zurückgibt, die bestimmte erweiterte ANSI-Zeichen enthält, und die 8-Bit-Konsolenfunktionen so festgelegt sind, dass sie die OEM-Codepage verwenden, wird die Zeichenfolge von der WriteConsoleA-Funktion nicht ordnungsgemäß angezeigt.

Verwenden Sie die AreFileApisANSI-Funktion , um zu bestimmen, welche Codepage der Satz von Datei-E/A-Funktionen derzeit verwendet. Verwenden Sie die Funktionen SetConsoleCP und SetConsoleOutputCP , um die Codepage für die 8-Bit-Konsolenfunktionen festzulegen.

Um das Problem der Inkompatibilität von Codeseiten zu beheben, empfiehlt es sich, Unicode für Konsolenanwendungen zu verwenden. Konsolenanwendungen, die Unicode verwenden, sind viel vielseitiger als diejenigen, die 8-Bit-Konsolenfunktionen verwenden. Abgesehen von dieser Lösung kann eine Konsolenanwendung die Funktion SetFileApisToOEM aufrufen, damit der Satz von Datei-E/A-Funktionen OEM-Zeichensatzzeichenfolgen anstelle von ANSI-Zeichensatzzeichenfolgen verwendet. Verwenden Sie die SetFileApisToANSI-Funktion , um diese Funktionen wieder auf die ANSI-Codepage festzulegen.

Wenn es sich um Befehlszeilen handelt, sollte eine Konsolenanwendung die Befehlszeile im Unicode-Format abrufen und sie dann mithilfe der relevanten Zeichen-zu-OEM-Funktionen in das OEM-Formular konvertieren. Beachten Sie auch, dass das Array im argv-Parameter der Befehlszeilenfunktion Standard in diesem Fall ANSI-Zeichensatzzeichenfolgen enthält.

Unter Windows 8 und Windows Server 2012 wird diese Funktion von den folgenden Technologien unterstützt.

Technologie	Unterstützt
SMB 3.0-Protokoll (Server Message Block)	Ja
SMB 3.0 Transparent Failover (TFO)	Ja
SMB 3.0 mit Dateifreigaben mit horizontaler Skalierung (SO)	Ja
Dateisystem mit freigegebenen Clustervolumes (CsvFS)	Ja
Robustes Dateisystem (Resilient File System, ReFS)	Ja

Anforderungen


Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	fileapi.h (einschließlich Windows.h, WinBase.h)
Bibliothek	Kernel32.lib
DLL	Kernel32.dll