1 Class RFs

     2 class RFs : public RSessionBase;

     3 Description

     4 A handle to a file server session.

     5 

     6 A program or thread may have arbitrarily many sessions open simultaneously.

     7 

     8 Use this class for all file system manipulation, including:

     9 

    10 1. adding, removing, moving and renaming files and directories

    11 

    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.

    13 

    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

    15 

    16 4. getting directory listings

    17 

    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.

    19 

    20 6. performing context-sensitive parses using TParse objects, and the session path

    21 

    22 7. obtaining information on drives and volumes

    23 

    24 8. formatting and labelling volumes

    25 

    26 9. obtaining a list of valid drives

    27 

    28 10. emulating the DOS subst command, which allows any directory to appear as if it were a separate drive

    29 

    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.

    31 

    32 12. finding the version number of the file server

    33 

    34 13. resource counting to ensure that all resources are closed when the session terminates.

    35 

    36 This class is not intended for user derivation.

    37 

    38 The following restrictions apply when a path is specified:

    39 

    40 1. its total length must not exceed 256 characters

    41 

    42 2. wildcards cannot be used in the drive or in any directory name, although they may be allowed in the filename and extension.

    43 

    44 3. double backslashes are not allowed in the path.

    45 

    46 4. the following characters must not be included anywhere in the path: < > " / |

    47 

    48 5. a colon may only be included between the drive and path

    49 

    50 6. no directory name or filename plus extension may consist solely of space characters, or of a single or double dot.

    51 

    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. 

    53