Click above to get retro games delivered to your door ever month!

 DrvRootMap()
------------------------------------------------------------------------------
 Purpose:
 Create or delete a "fake root" network directory mapping.

 Syntax:
 bResult = DrvRootMap( lpszDrive, lpszPath )

 Parameters:
 lpszDrive The drive letter for the fake root.
 lpszPath  The full NetWare path name of the fake root.

 Returns:
 A boolean value (TRUE or FALSE).

 The CA-Clipper name for this function is:
 DrvRootMap()

 Description:
 DrvRootMap() creates or deletes a fake root drive mapping. A fake root
 is where a directory lpszPath is made to appear to DOS as if it is the
 root directory of drive lpszDrive. If lpszPath is specified, drive
 lpszDrive is mapped to the path lpszPath and made the root. lpszPath must
 be the full path to be the root, including the volume name, e.g.
 SYS:PUBLIC. If lpszPath is passed as a NULL string, the drive letter
 lpszDrive is converted back into a normal mapped drive.

 Returns TRUE if successful, or FALSE if an error occurs.

 Example:
 // To make directory SYS:PUBLIC appear as the root directory of drive "M":
 if ( DrvRootMap( "M", "SYS:PUBLIC" ) )
    ? "The root directory of drive M is actually"
    ?? "the server directory SYS:PUBLIC"
 endif

 Notes:
 This function only works on Version 3.x workstation shells.