FsRtlIsFatDbcsLegal 函式 （ntifs.h）

FsRtlIsFatDbcsLegal 例程會判斷指定的 ANSI 或雙位元組字元集 （DBCS） 字串是否為合法的 FAT 檔名。

語法

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

參數

[in] DbcsName

要測試之字串的指標。

[in] WildCardsPermissible

如果通配符視為合法字元，請將 設為 TRUE，否則 FALSE。

[in] PathNamePermissible

如果 DbcsName 可以是包含反斜杠字元的完整路徑名稱，請設定為 true TRUE 如果只能是檔名，FALSE。

[in] LeadingBackslashPermissible

如果檔案或pathname中允許單一前置反斜杠，則設定為 TRUE，否則 為 FALSE。

傳回值

如果字串是合法的 FAT 檔名，FsRtlIsFatDbcsLegal 例程會傳回 true TRUE ，否則為 FALSE。

言論

FsRtlIsFatDbcsLegal 例程會判斷指定的檔名是否符合法務檔名的 FAT 特定規則。 此例程會檢查檔名，或者，如果 PathNamePermissible 指定 為 true，則整個路徑名稱是否為合法的 FAT 名稱。

FAT 檔案名必須遵守下列規則：

• 下列字元在 FAT 檔名中是非法的：0x00-0x1F、"（直引號）、/（斜線）、:（冒號）、|（垂直橫條或管道）、+（加號）、,（逗號）、;（分號）、=（等號）、[ ]（括號）
• FAT 檔名是格式 N.E 或只是 N，其中 N 是一到八個字節的字串，E 是符合規則一的一到三個字節的字元串。 此外，N 或 E 都不能包含 .（句號）或結尾的空格字元。 例如，.foo、foo.和 foo .b 的檔案是非法的，而 foo. b 和 bar 是合法的。
• FAT 檔名不區分大小寫。 小寫名稱會自動轉換成大寫。

如需其他字串處理例程的詳細資訊，請參閱 Run-Time連結庫 （RTL） 例程。

要求

另請參閱

ANSI_STRING