Fonction SetFileApisToANSI (fileapi.h)

Article
08/23/2023

Demande aux fonctions d’E/S de fichiers d’utiliser la page de code du jeu de caractères ANSI pour le processus en cours. Cette fonction est utile pour les opérations d’entrée et de sortie de console 8 bits.

Syntaxe

void SetFileApisToANSI();

Valeur de retour

None

Notes

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

La fonction SetFileApisToANSI complète la fonction SetFileApisToOEM , qui permet au même ensemble de fonctions d’E/S de fichier d’utiliser la page de code du jeu de caractères OEM.

Les fonctions de console 8 bits utilisent la page de code OEM par défaut. Toutes les autres fonctions utilisent la page de code 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 qui contient certains caractères ANSI étendus et que les fonctions de console 8 bits sont définies pour utiliser la page de code OEM, la fonction WriteConsoleA n’affiche pas correctement la chaîne.

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

Pour résoudre le problème d’incompatibilité de page de code, 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 renvoyer ces fonctions à la page de code ANSI.

Lors du traitement 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 ligne de commande main 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