Fonction FsRtlIsFatDbcsLegal (ntifs.h)

La routine FsRtlIsFatDbcsLegal détermine si la chaîne ANSI ou d’un jeu de caractères double octet (DBCS) spécifiée est un nom de fichier FAT légal.

Syntaxe

BOOLEAN FsRtlIsFatDbcsLegal(
  [in] ANSI_STRING DbcsName,
  [in] BOOLEAN     WildCardsPermissible,
  [in] BOOLEAN     PathNamePermissible,
  [in] BOOLEAN     LeadingBackslashPermissible
);

Paramètres

[in] DbcsName

Pointeur vers la chaîne à tester.

[in] WildCardsPermissible

Définissez sur TRUE si les caractères génériques doivent être considérés comme légaux, FALSE dans le cas contraire.

[in] PathNamePermissible

Défini sur TRUE si DbcsName peut être un nom de chemin complet contenant des caractères de barre oblique inverse, FALSE s’il ne peut s’agir que du nom de fichier.

[in] LeadingBackslashPermissible

Définissez la valeur TRUE si une seule barre oblique inverse de début est autorisée dans le fichier ou le nom du chemin d’accès, FALSE sinon.

Valeur retournée

La routine FsRtlIsFatDbcsLegal retourne TRUE si la chaîne est un nom de fichier FAT légal, FALSE sinon.

Remarques

La routine FsRtlIsFatDbcsLegal détermine si le nom de fichier spécifié est conforme aux règles propres à FAT pour les noms de fichiers légaux. Cette routine case activée le nom du fichier ou, si PathNamePermissible est spécifié comme TRUE, si le chemin d’accès entier est un nom FAT légal.

Les noms de fichiers FAT doivent respecter les règles suivantes :

• Les caractères suivants sont interdits dans les noms de fichiers FAT : 0x00-0x1F, " (guillemets droits), / (barre oblique), : (deux-points), | (barre verticale ou canal), + (plus), , (virgule), ; (point-virgule), = (signe égal), [ ] (crochets)
• Un nom de fichier FAT est de la forme N.E ou simplement N, où N est une chaîne de un à huit octets et E une chaîne de un à trois octets conforme à la règle 1. En outre, ni ne NE peut contenir de . (point) ou se terminer par un caractère d’espace. Par exemple, les fichiers .foo, foo.et foo .b sont illégaux, tandis que foo. b et bar sont légaux.
• Les noms de fichiers FAT ne respectent pas la casse. Les noms minuscules sont automatiquement convertis en majuscules.

Pour plus d’informations sur d’autres routines de gestion de chaînes, consultez Routines de la bibliothèque d’exécution (RTL).

Configuration requise

Voir aussi

ANSI_STRING