Naming a File
Although each file system can have specific rules about the formation of individual components in a directory or file name, all file systems follow the same general conventions: a base file name and an optional extension, separated by a period.
For example, the MS-DOS FAT file system supports 8 characters for the base file name and 3 characters for the extension. This is known as an 8.3 file name. The FAT file system and the NTFS file system are not limited to 8.3 file names, because they support a long file name.
Naming Conventions
The following rules enable applications to create and process valid names for files and directories regardless of the file system:
* Use a period (.) to separate the base file name from the extension in a directory name or file name.
* Use a backslash (\) to separate components in paths, which divides the file name from the path to it, or one directory from one another in a path. You cannot use a backslash in file or directory names. However, they can be required as part of volume names, for example, "C:\". UNC names must have the following format: \\<server>\<share>.
* Use any character in the current code page for a name, including Unicode characters, except characters in the range of zero (0) through 31, or any character that the file system does not allow. A name can contain characters in the extended character set (128–255). However, it cannot contain the following reserved characters:
< > : " / \ | ? *
* Use a period (.) as a directory component in a path to represent the current directory.
* Use two consecutive periods (..) as a directory component in a path to represent the parent of the current directory.
* Do not use the following reserved device names for the name of a file: CON, PRN, AUX, NUL, COM1, COM2, COM3, COM4, COM5, COM6, COM7, COM8, COM9, LPT1, LPT2, LPT3, LPT4, LPT5, LPT6, LPT7, LPT8, and LPT9. Also avoid these names followed by an extension, for example, NUL.tx7.
* Do not assume case sensitivity. Consider names such as OSCAR, Oscar, and oscar to be the same.
* Do not end a file or directory name with a trailing space or a period. Although the underlying file system may support such names, the operating system does not. You can start a name with a period (.).
Maximum Path Length
In the Windows API, the maximum length for a path is MAX_PATH, which is defined as 260 characters. A path is structured in the following order: drive letter, colon, backslash, components separated by backslashes, and a null-terminating character, for example, the maximum path on the D drive is D:\<256 chars>NUL.
Note Functions in the Windows API convert "/" to "\" as part of converting the name to an NT style name.
The Unicode versions of several functions permit a maximum path length of approximately 32,000 characters composed of components up to 255 characters in length. To specify that kind of path, use the "\\?\" prefix.
Note The maximum path of 32,000 characters is approximate, because the "\\?\" prefix can be expanded to a longer string, and the expansion applies to the total length.
For example, "\\?\D:\<path>". To specify such a UNC path, use the "\\?\UNC\" prefix. For example, "\\?\UNC\<server>\<share>". These prefixes are not used as part of the path itself. They indicate that the path should be passed to the system with minimal modification, which means that you cannot use forward slashes to represent path separators, or a period to represent the current directory. Also, you cannot use the "\\?\" prefix with a relative path. Relative paths are limited to MAX_PATH characters.
When using the API to create a directory, the specified path cannot be so long that you cannot not append an 8.3 file name.
The shell and the file system may have different requirements. It is possible to create a path with the API that the shell UI cannot handle.
Relative Paths
For functions that manipulate files, the file names can be relative to the current directory. A file name is relative to the current directory if it does not begin with one of the following:
* A disk designator, which is either a drive letter followed by a colon, or a server name and share name (\\servername\sharename).
* A directory name separator, such as a backslash, for example, \subdir).
If the file name begins with a disk designator and a backslash (\), it is a full path (for example, c:\tmp). If a file name begins with only a disk designator, it is a relative path to the current directory on the drive with the specified letter (for example, c:tmp.txt refers to a file in the current directory on the C drive).
Short and Long File Names
Typically, Windows stores the long file names on disk as special directory entries, which can be disabled for performance reasons. When you create a long file name, Windows also creates the short MS-DOS (8.3) form of the name. On many file systems, a short file name contains a tilde (~) character. However, not all file systems follow this convention. Therefore, do not make this assumption.
To get MS-DOS file names, long file names, or the full path of a file you can do the following:
* To get an MS-DOS file name that has a long file name, use the GetShortPathName function.
* To get the long file name that has a short name, use the GetLongPathName function.
* To get the full path of a file, use the GetFullPathName function.
Windows stores the long file names on disk in Unicode, which means that the original long file name is always preserved, even if it contains extended characters, and regardless of the code page that is active during a disk read or write operation. The case of the file name is preserved, but the file system is not case-sensitive.
The valid character set for long file names is the Unicode file system character set minus the colon (':') that the NTFS file system uses to open alternate file streams, which means that you can copy files between the NTFS file system and FAT file system partitions without losing any file name information.