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

 DrvSchOrdGet()
------------------------------------------------------------------------------
 Purpose:
 Get the search order for a drive.

 Syntax:
 iOrder = DrvSchOrdGet( lpszDrive )

 Parameters:
 lpszDrive The drive letter.

 Returns:
 A numeric value (signed short int).

 Description:
 DrvSchOrdGet() returns the search order of the drive letter
 specified by lpszDrive.

 Returns NOVERRINT if an error has occurred. Returns 0 if the drive is not a
 search drive.

 Example:
 // To return the search order of drive Y:
 iDriveOrder = DrvSchOrdGet("Y")
 do case
    case DriveOrder > 0
       ? "Drive Y has search order", iDriveOrder
    case DriveOrder = 0
       ? "Drive Y is not in the search path"
    otherwise
       ? "Error"
 endcase

 Notes:
 Return range is 1 to 16.