FsRtlIsHpfsDbcsLegal, fonction (ntifs.h)

La routine FsRtlIsHpfsDbcsLegal détermine si la chaîne ANSI ou DBCS spécifiée est un nom de fichier HPFS légal.

Syntaxe

BOOLEAN FsRtlIsHpfsDbcsLegal(
  [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éfinissez sur TRUE si DbcsName peut être un nom de chemin complet contenant des barres obliques inverses, FALSE s’il ne peut s’agir que d’un nom de fichier.

[in] LeadingBackslashPermissible

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

Valeur retournée

La routine FsRtlIsHpfsDbcsLegal retourne TRUE si la chaîne est un nom de fichier HPFS légal, false dans le cas contraire.

Remarques

La routine FsRtlIsHpfsDbcsLegal détermine si le nom de fichier spécifié est conforme aux règles spécifiques à HPFS pour les noms de fichiers légaux. Cette routine case activée le nom de fichier ou, si PathNamePermissible est spécifié comme TRUE, si le nom de chemin entier est un nom HPFS légal.

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

  • Les caractères suivants ne sont pas valides dans les noms de fichiers HPFS : 0x0000 - 0x001F, " (guillemets), / (barre oblique), : (deux-points), < (signe inférieur à), > (signe supérieur à), ? (point d’interrogation), | (barre verticale ou canal), * (astérisque)

  • Un nom de fichier HPFS ne peut pas se terminer par un point ou un espace. Par exemple, les fichiers « foo » et « foo. » sont illégaux, tandis que . foo », « foo » et « foo.bar.foo » sont légaux.

  • Un nom de fichier HPFS ne peut pas contenir plus de 255 octets.

  • Les noms de fichiers HPFS préservent la casse, mais ne respectent pas la casse. Les noms de fichiers minuscules ne sont pas automatiquement convertis en majuscules. Toutefois, la casse est ignorée dans les comparaisons de noms de fichiers.

Configuration requise

Condition requise Valeur
Client minimal pris en charge Windows 2000
Plateforme cible Universal
En-tête ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothèque NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Voir aussi

ANSI_STRING