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

 SchVectorDriveAdd()
------------------------------------------------------------------------------
 Warning:
 USE WITH EXTREME CAUTION.

 This is a support function for programmers who understand NetWare well. If
 used incorrectly it could cause confusing events, or possibly corrupt data.
 The drive letter must already have been mapped before this function is
 called.

 Purpose:
 Add a drive to the search vector.

 Syntax:
 bResult = SchVectorDriveAdd( lpszDrive, wOrder )

 Parameters:
 lpszDrive The drive letter.
 wOrder    The search order.

 Returns:
 A boolean value (TRUE or FALSE).

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

 Description:
 SchVectorDriveAdd() adds a new drive letter specified by lpszDrive to the
 search drive vector and PATH environment variable at the position specified
 by the search order wOrder. If wOrder is specified as NOVDEFINT,
 SchVectorDriveAdd() adds the drive letter to the end of the vector.

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

 Example:
 // To add drive M to the drive vector at search order 4:
 if ( SchVectorDriveAdd( "M", 4 ) )
    ? "Drive M: added to the search vector"
 endif

 Notes:
 This function DOES NOT map a search drive; see SchDriveDirMap().