Retro video games delivered to your door every month!
Click above to get retro games delivered to your door ever month!
X-Hacker.org- Advantage CA-Clipper Guide v5.5 - ax_getdrive() http://www.X-Hacker.org [<<Previous Entry] [^^Up^^] [Next Entry>>] [Menu] [About The Guide]
 AX_GetDrive()
 Determines the location of a table
------------------------------------------------------------------------------

 Syntax

     AX_GetDrive( <cFileSpec> ) -> charstring

     <cFileSpec> A required character string representing a file name.
     You may indicate the table name with or without the ".dbf"
     extension.

 Returns

     Returns a fully qualified path name including server, share/volume,
     path and table.  A ".DBF" extension will be added if an
     extension is not given.

     If the file exists on a local drive, or an error occurs, this function
     returns an empty string ("").  If Rights Checking is ON, and
     the file does not exist, this function returns an empty string ("").

 Description

     AX_GetDrive() determines the location of the specified table
     The fully qualified path, including the server, share/volume and
     directory names, are returned.  This function respects CA-Clipper's
     SET DEFAULT commands.  If Rights Checking is ON, this function respects
     CA-Clipper's SET PATH command.

 Example

     LOCAL cName

     SET DEFAULT TO n:\dbf

     // Get the full network path of CUST.DBF
     cName = AX_GetDrive( "Cust" )

     // This will return something like \\SERVER\SHARE\DBF\CUST.DBF or
     //   SERVER\VOLUME\CUST.DBF
     ? cName

     // This is how the Advantage AUTOUSE command verifies Advantage
     // Database Server existence.  Note, this will respect the SET DEFAULT
     // value.

     ? AX_Loaded( AX_GetDrive( "Cust" ) )    // Displays .T. if Advantage
                                             // is available


See Also: AX_Loaded() AX_Driver()

Online resources provided by: http://www.X-Hacker.org --- NG 2 HTML conversion by Dave Pearson