FN_SPECAPF()
 Specify Capture File
------------------------------------------------------------------------------
 Syntax
 
      fn_speCapF(cPath, nDriveHandle) -> lWorked
 
 Arguments

     <cPath> - An absolute path or a path relative to the directory
               handle that specifies the file to be created or used
               as a permanent capture file.

     <nDriveHandle> - points to an entry in the server's directory
                      handle table for the calling workstation.
                      This is an internal table kept by Netware to
                      handle drive mappings.  You will need to understand
                      how to use some of the Directory services to use
                      this parameter

                      If a 0 is passed for the nDriveHandle, then the path
                      must be the full Netware Path. For example:

                          "SYS:HOME/KEVIN/filename.ext"

                      The user must have write access to the path.

 Returns

     <lWorked> - if the function call worked


 Description
     This function creates a disk file and directs that the next
     capture of print stream data go into the file.  The contents of
     that file are lost.  Must be used for the default print device.
     The file is closed when the application invokes a cancel capture,
     end capture or flush capture.


 Examples


 Source: N:\SRC\PRINT\CAPTFILE.PRG

 Author: Kevin Maher/Steve Tyrakowski