Freigeben über


FsRtlIsHpfsDbcsLegal-Funktion (ntifs.h)

Die FsRtlIsHpfsDbcsLegal-Routine bestimmt, ob die angegebene ANSI- oder DBCS-Zeichenfolge (Double-Byte Character Set) ein legaler HPFS-Dateiname ist.

Syntax

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

Parameter

[in] DbcsName

Ein Zeiger auf die zu testende Zeichenfolge.

[in] WildCardsPermissible

Legen Sie auf TRUE fest, wenn Wildcardzeichen als zulässig angesehen werden sollen, andernfalls FALSE.

[in] PathNamePermissible

Auf TRUE festgelegt, wenn DbcsName ein vollständiger Pfadname sein kann, der umgekehrte Schrägstrichzeichen enthält, FALSE, wenn es sich nur um einen Dateinamen handeln kann.

[in] LeadingBackslashPermissible

Legen Sie auf TRUE fest, wenn ein einzelner führender umgekehrter Schrägstrich in der Datei oder im Pfadnamen zulässig ist, andernfalls FALSE.

Rückgabewert

Die FsRtlIsHpfsDbcsLegal-Routine gibt TRUE zurück, wenn die Zeichenfolge ein gesetzlicher HPFS-Dateiname ist, andernfalls FALSE.

Hinweise

Die FsRtlIsHpfsDbcsLegal-Routine bestimmt, ob der angegebene Dateiname den HPFS-spezifischen Regeln für juristische Dateinamen entspricht. Diese Routine überprüft den Dateinamen oder, wenn PathNamePermissible als TRUE angegeben ist, ob der gesamte Pfadname ein legaler HPFS-Name ist.

HPFS-Dateinamen müssen den folgenden Regeln entsprechen:

  • Die folgenden Zeichen sind in HPFS-Dateinamen unzulässig: 0x0000 - 0x001F, " (Anführungszeichen), / (Schrägstrich), : (Doppelpunkt), < (kleiner als Zeichen), > (größer als Zeichen), ? (Fragezeichen), | (vertikaler Balken oder Strich), * (Sternchen)

  • Ein HPFS-Dateiname kann nicht mit einem Punkt oder einem Leerzeichen enden. Beispielsweise sind die Dateien "foo " und "foo." illegal, während ".foo", " foo" und "foo.bar.foo" legal sind.

  • Ein HPFS-Dateiname darf nicht mehr als 255 Bytes enthalten.

  • BEI HPFS-Dateinamen wird die Groß-/Kleinschreibung beibehalten, die Groß-/Kleinschreibung wird jedoch nicht beachtet. Dateinamen in Kleinbuchstaben werden nicht automatisch in Großbuchstaben konvertiert. Die Groß-/Kleinschreibung wird jedoch bei Dateinamenvergleichen ignoriert.

Anforderungen

Anforderung Wert
Unterstützte Mindestversion (Client) Windows 2000
Zielplattform Universell
Header ntifs.h (include FltKernel.h, Ntifs.h)
Bibliothek NtosKrnl.lib
DLL NtosKrnl.exe
IRQL <= APC_LEVEL

Weitere Informationen

ANSI_STRING