[<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
   Function:   Qualify()

               Qualify() is used to expand a filename to a fully
               filled drive:\path\filename combination. It uses a
               (non-documented) DOS function to achieve that,
               I've had no problems to date with it. It can come
               in handy in numerous situations.

   Syntax:     qualify(<cFileName>) --> cFullName

   Arguments:  <cFileName> is the filename you want to qualify.

   Returns:    The fully qualified string or NULL string if there
               was an error in the original name (invalid file name,
               malformed path). Qualify(), however, also recognises
               a possible new Path or Filename, which is thus
               considered legal.

   Usage:      Qualify is useful to attach a full path to a
               filename, so that when changing directories, the
               filename still applies to the same file. One good
               example is using it with Submitfile(), for
               enqueing files to be printed.

Some Notes on Qualify():
*   The input path need not actually exist, as
    one may want to use it to expand a file/path
    to be created.

*   Letters are Uppercased, Forward slashes become
    backward slashes, asterisks become question marks,
    directory and file names are truncated to 8 letters
    with a 3 letter extension, eventual .'s and ..'s in
    the path are resolved.

*   On local drives, the filespec returned always starts
    with D:, on network drives it always starts with
    \\<Machine>, and not the current drive mapping.

*   When qualify is done on a JOINed, SUBSTituted or
    ASSIGNed drive. The combination returned is one that
    would be required when any of those commands is not
    active. This could lead to some problems on network
    drives.

See Also: SubmitFile() ChDir()
This page created by ng2html v1.05, the Norton guide to HTML conversion utility. Written by Dave Pearson