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

 SchVectorGet() / SchVectorSet()
------------------------------------------------------------------------------
 Warning:
 USE WITH EXTREME CAUTION.

 If you attempt to change the search drive vector by passing lpszNewVector
 to SchVectorSet(), you may destroy its alignment to the DOS PATH variable
 with which it is closely related. This can result in very ambiguous errors
 and possible data loss.

 Purpose:
 Get or set the search vector.

 Syntax:
 lpszVector = SchVectorGet()
 lpszVector = SchVectorSet( lpszNewVector )

 Parameters:
 lpszNewVector The new search drive vector.

 Returns:
 A character string of length 16.

 The CA-Clipper names for these functions are:
 SchVecGet() / SchVecSet()

 Description:
 SchVectorGet() returns the current search drive vector of the workstation.
 The search drive vector is a 16 byte string, containing a list of search
 drives in the order in which NetWare is to search them.

 SchVectorSet() sets the vector to the new value specified by lpszNewVector.
 If successful, SchVectorSet() returns the previous settings of the vector.
 A typical return value from SchVectorSet() would be "ZYXT".

 Returns an empty string if an error occurs.

 Example:
 // To return the current search drive vector:
 lpszCurrVector = SchVectorGet()
 if ( !empty( lpszCurrVector ) )
    ? "The current search drive vector is", lpszCurrVector
 endif

 Notes:
 The search vector is terminated with an 0xff (255 decimal)
 character.