FsRtlIsHpfsDbcsLegal, fonction (ntifs.h)

Article
12/21/2024

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 la valeur TRUE si les caractères génériques doivent être considérés comme légaux, FALSE sinon.

[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 d’un nom de fichier.

[in] LeadingBackslashPermissible

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

Valeur de retour

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

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 juridiques. Cette routine vérifie le nom du fichier ou, si PathNamePermissible est spécifié comme TRUE, si le chemin d’accès entier est un nom HPFS légal.

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

Les caractères suivants sont interdits 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égal, tandis que .foo », « foo » et « foo.bar.foo » sont légaux.
Un nom de fichier HPFS ne peut contenir plus de 255 octets.
Les noms de fichiers HPFS conservent la casse, mais ne respectent pas la casse. Les noms de fichiers minuscules ne sont pas automatiquement convertis en majuscules. Toutefois, le cas est ignoré dans les comparaisons de noms de fichiers.

Exigences

Exigence	Valeur
client minimum pris en charge	Windows 2000
plateforme cible	Universel
d’en-tête	ntifs.h (include FltKernel.h, Ntifs.h)
bibliothèque	NtosKrnl.lib
DLL	NtosKrnl.exe
IRQL	<= APC_LEVEL

Voir aussi

ANSI_STRING

Partager via