FsRtlIsHpfsDbcsLegal-Funktion (ntifs.h)

Die FsRtlIsHpfsDbcsLegal- Routine bestimmt, ob die angegebene ANSI- oder DBCS-Zeichenfolge ein zulässiger 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

Auf TRUE festgelegt, wenn Wildcardzeichen als zulässig betrachtet werden sollen, andernfalls FALSE.

[in] PathNamePermissible

Auf TRUE festgelegt, wenn DbcsName- ein vollständiger Pfadname sein kann, der umgekehrte Schrägstriche enthält, FALSE, wenn es nur ein Dateiname sein kann.

[in] LeadingBackslashPermissible

Wird auf TRUE festgelegt, wenn ein einzelner vorangestellter Umgekehrter Schrägstrich in der Datei oder dem Pfadnamen zulässig ist, andernfalls FALSE.

Rückgabewert

Die FsRtlIsHpfsDbcsLegal- Routine gibt WAHR zurück, wenn die Zeichenfolge ein zulässiger HPFS-Dateiname ist, andernfalls FALSE.

Bemerkungen

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 wird, ob der gesamte Pfadname ein zulässiger 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 Rohr), * (Sternchen)

• Ein HPFS-Dateiname kann nicht in 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 maximal 255 Byte enthalten.

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

Anforderungen

Anforderung	Wert
mindestens unterstützte Client-	Windows 2000
Zielplattform-	Universal
Header-	ntifs.h (include FltKernel.h, Ntifs.h)
Library	NtosKrnl.lib
DLL-	NtosKrnl.exe
IRQL-	<= APC_LEVEL

Siehe auch

ANSI_STRING