SetFileApisToOEM, fonction (fileapi.h)

Article
08/23/2023

Oblige les fonctions d’E/S de fichiers du processus à utiliser la page de code du jeu de caractères OEM. Cette fonction est utile pour les opérations d’entrée et de sortie de console 8 bits.

Syntaxe

void SetFileApisToOEM();

Valeur de retour

None

Notes

Les fonctions d’E/S de fichier dont la page de codes est définie par SetFileApisToOEM sont les fonctions exportées par KERNEL32.DLL qui acceptent ou retournent un nom de fichier. SetFileApisToOEM définit la page de codes par processus, plutôt que par thread ou par ordinateur.

La fonction SetFileApisToOEM est complétée par la fonction SetFileApisToANSI , qui fait que le même ensemble de fonctions d’E/S de fichier utilise la page de codes du jeu de caractères ANSI.

Les fonctions de console 8 bits utilisent la page de codes OEM par défaut. Toutes les autres fonctions utilisent la page de codes ANSI par défaut. Cela signifie que les chaînes retournées par les fonctions de console peuvent ne pas être traitées correctement par d’autres fonctions, et vice versa. Par exemple, si la fonction FindFirstFileA retourne une chaîne contenant certains caractères ANSI étendus et que les fonctions de console 8 bits sont définies pour utiliser la page de codes OEM, la fonction WriteConsoleA n’affiche pas correctement la chaîne.

Utilisez la fonction AreFileApisANSI pour déterminer la page de codes que le jeu de fonctions d’E/S de fichier utilise actuellement. Utilisez les fonctions SetConsoleCP et SetConsoleOutputCP pour définir la page de codes pour les fonctions de console 8 bits.

Pour résoudre le problème d’incompatibilité des pages de codes, il est préférable d’utiliser Unicode pour les applications console. Les applications console qui utilisent Unicode sont beaucoup plus polyvalentes que celles qui utilisent des fonctions console 8 bits. À l’exception de cette solution, une application console peut appeler la fonction SetFileApisToOEM pour que le jeu de fonctions d’E/S de fichier utilise des chaînes de jeu de caractères OEM plutôt que des chaînes de jeu de caractères ANSI. Utilisez la fonction SetFileApisToANSI pour définir ces fonctions sur la page de codes ANSI.

Lorsqu’elle traite des lignes de commande, une application console doit obtenir la ligne de commande au format Unicode, puis la convertir en formulaire OEM à l’aide des fonctions caractère-à-OEM appropriées. Notez également que le tableau dans le paramètre argv de la fonction de main de ligne de commande contient des chaînes de jeu de caractères ANSI dans ce cas.

Dans Windows 8 et Windows Server 2012, cette fonction est prise en charge par les technologies suivantes.

Technologie	Prise en charge
Protocole Server Message Block (SMB) 3.0	Oui
Basculement transparent SMB 3.0 (TFO)	Oui
SMB 3.0 avec partages de fichiers avec montée en puissance parallèle (SO)	Oui
Système de fichiers du volume partagé de cluster (CsvFS)	Oui
Système de fichiers résilient (ReFS)	Oui

Configuration requise


Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	fileapi.h (inclure Windows.h, WinBase.h)
Bibliothèque	Kernel32.lib
DLL	Kernel32.dll