2 class RFs : public RSessionBase;
4 A handle to a file server session.
6 A program or thread may have arbitrarily many sessions open simultaneously.
8 Use this class for all file system manipulation, including:
10 1. adding, removing, moving and renaming files and directories
12 2. inspecting and changing file attributes and directory entry details. These include the time and date when the file or directory was last written to, its size and various attribute flags such as read-only, hidden, archive or system.
14 3. finding a file?s real name; if the file system on which it is stored has to "mangle" the name into a shorter format
16 4. getting directory listings
18 5. maintaining a default path; unlike some other systems, there is a single system default path, rather than one for each drive: the default path consists of a drive and a path specification.
20 6. performing context-sensitive parses using TParse objects, and the session path
22 7. obtaining information on drives and volumes
24 8. formatting and labelling volumes
26 9. obtaining a list of valid drives
28 10. emulating the DOS subst command, which allows any directory to appear as if it were a separate drive
30 11. requesting notification of when significant change occurs. This can be used for programs which maintain file lists, but must update those lists when change occurs.
32 12. finding the version number of the file server
34 13. resource counting to ensure that all resources are closed when the session terminates.
36 This class is not intended for user derivation.
38 The following restrictions apply when a path is specified:
40 1. its total length must not exceed 256 characters
42 2. wildcards cannot be used in the drive or in any directory name, although they may be allowed in the filename and extension.
44 3. double backslashes are not allowed in the path.
46 4. the following characters must not be included anywhere in the path: < > " / |
48 5. a colon may only be included between the drive and path
50 6. no directory name or filename plus extension may consist solely of space characters, or of a single or double dot.
52 7. spaces between the drive, if specified, and the first directory in the path are illegal, although there may be spaces between other path components, for instance between directories.