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

 SchDriveDirMap()
------------------------------------------------------------------------------
 Purpose:
 Map a network directory to a search drive.

 Syntax:
 iHandle = SchDriveDirMap(lpszDrive, lpszPath, wOrder)

 Parameters:
 lpszDrive The drive letter or an empty character for the next
           available drive.
 lpszPath  The full NetWare path of the directory to map.
 wOrder    The search order.

 Returns:
 A numeric value (signed short int).

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

 Description:
 SchDriveDirMap() is used to map a new search drive.

 lpszPath is the full path name, including the volume name of the directory
 to map to the search drive. lpszDrive is either the drive letter or an
 empty (NULL) string to instruct SchDriveDirMap() to choose the next
 available drive letter. The next letter will be in descending order, e.g.
 Z, Y, X etc.

 If the search order wOrder is passed, SchDriveDirMap() will insert it at
 the position wOrder. If wOrder is passed as NOVDEFINT, SchDriveDirMap()
 will add the new search drive to the end of the search order.

 Returns the new directory handle of the drive, or NOVERRINT if an error
 occurs.

 Example:
 // To map drive S as the 3rd search drive to directory SYS:DATA:
 iDirHan = SchDriveDirMap( "S", "SYS:DATA", 3 )
 if ( iDirHan != NOVERRINT )
    ? "Drive S is mapped to SYS:DATA and is the 3rd search drive"
 endif
 // To map the next available drive letter and order to SYS:HOME:
 iDirHan = SchDriveDirMap( "", "SYS:HOME", NOVDEFINT )
 if ( iDirHan != NOVERRINT )
    ? "A new drive has been mapped to SYS:HOME"
 endif

 Notes:
 If the drive already exists, the existing mapping is deleted and
 remapped.