Management and searching

This topic describes the classes that provide high level file system functions which can operate on files and directories located throughout a directory hierarchy and which can take some time to complete.

The classes provide services to:

  • scan through a hierarchy, upwards or downwards, returning a filtered list of the entries contained in each directory

  • carry out file management operations on files and directories in the hierarchy, for example, deleting an entire directory structure or moving a group of files

  • search for each occurrence of a filename in one or more directories.

File management is provided by CFileMan class. Its functions may operate recursively or non-recursively and accept the use of wildcards. Synchronous and asynchronous variants are provided for each of these functions and the use of the MFileManObserver protocol allows user notification to take place during the operation.

TFindFile and CFileMan classes support the use of wildcard characters. An asterisk indicates any number of characters, and a question mark indicates a single character. Note that in the context of these classes, * and *.* are equivalent and match to all files, with and without extensions. Filename matching is case insensitive.

Before using any of these classes, a connection to a file server session must have been made and is passed to the constructor of the class.