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

 SchDriveMapDelete()
------------------------------------------------------------------------------
 Purpose:
 Delete a network search drive mapping.

 Syntax:
 bResult = SchDriveMapDelete( wOrder )

 Parameters:
 wOrder The search order of the search drive to delete.

 Returns:
 A boolean value (TRUE or FALSE).

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

 Description:
 SchDriveMapDelete() deletes a search drive, specified by its search order
 wOrder. In doing so it deletes both the search allocation and the
 directory handle, thus deleting the mapping of the associated drive.

 Returns FALSE if an error occurs.

 Example:
 // To delete search drive S3: from the workstation's drive mappings:
 if ( SchDriveMapDelete(3) )
    ? "Search drive S3: is now deleted"
 endif

 Notes:
 This function deallocates the directory handle, deletes the drive
 from the PATH variable, and then aligns the search drive vector to the
 PATH.

 Appropriate trustee access rights are required.