SAMPLE: Fp0779.exe ISDISKIN Utility

The information in this article applies to:

• Microsoft FoxPro for MS-DOS, versions 1.02, 2.0, 2.5, 2.5a, 2.5b, 2.6

SUMMARY

Fp0779.exe is a sample that contains the ISDISKIN utility that provides an alternative method of dealing with the "Not Ready Reading Drive A" error message.

MORE INFORMATION

The following file is available for download from the Microsoft Software Library:

~ Fp0779.exe

For more information about downloading files from the Microsoft Software Library, please see the following article in the Microsoft Knowledge Base:

   ARTICLE-ID: Q119591
   TITLE     : How to Obtain Microsoft Support Files from Online Services

To provide an alternative method of dealing with this error, the ISDISKIN utility is included in the multiuser version of Microsoft FoxPro versions 1.02 and 2.0 for MS-DOS. A FoxPro application can call ISDISKIN to determine the status of the drive and, if necessary, provide a more appropriate message for the user.

THE TEXT OF FP0779

       Microsoft(R) Technical Support Application Note (Text File)
                       FP0779: ISDISKIN UTILITY

                                                   Revision Date: 2/94
                                                       1 Disk Included

| INFORMATION PROVIDED IN THIS DOCUMENT AND ANY SOFTWARE THAT MAY     |
| ACCOMPANY THIS DOCUMENT (collectively referred to as an Application |
| Note) IS PROVIDED "AS IS" WITHOUT WARRANTY OF ANY KIND, EITHER      |
| EXPRESSED OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE IMPLIED      |
| WARRANTIES OF MERCHANTABILITY AND/OR FITNESS FOR A PARTICULAR       |
| PURPOSE. The user assumes the entire risk as to the accuracy and    |
| the use of this Application Note. This Application Note may be      |
| copied and distributed subject to the following conditions:  1) All |
| text must be copied without modification and all pages must be      |
| included;  2) If software is included, all files on the disk(s)     |
| must be copied without modification (the MS-DOS utility diskcopy is |
| appropriate for this purpose);  3) All components of this           |
| Application Note must be distributed together;  and  4) This        |
| Application Note may not be distributed for profit.                 |
|                                                                     |
| Copyright (C) 1993-1994 Microsoft Corporation. All Rights Reserved. |
| Microsoft, FoxPro, and MS-DOS are registered trademarks and Windows |
| is a trademark of Microsoft Corporation.                            |
|---------------------------------------------------------------------|

INTRODUCTION

When a FoxPro program attempts to load a file from a floppy disk and no disk is present in the drive or the drive door is open, MS-DOS returns a "Not ready reading drive <letter>" message and provides the option to "Abort, Retry, Ignore" the error. The ISDISKIN utility on the disk enclosed with this Application Note is a binary file that provides an alternative method of dealing with this situation. A FoxPro application can call ISDISKIN to determine the status of the drive and, if necessary, provide a more appropriate message for the user.

NOTE: .BIN routines cannot be used in the Windows environment.

To install ISDISKIN

NOTE: If you are using the multiuser version of FoxPro 1.02 or 2.0, ISDISKIN.BIN is already installed in the FOXPRO2\GOODIES\ADDUSER directory by default.

1. Insert the enclosed FP0779 disk in your floppy disk drive.

2. Copy Isdiskin.bin to your main FoxPro directory. To do this, type the following at the MS-DOS command prompt and press ENTER

         copy <drive>:\isdiskin.bin <destination>
   

   where <drive> is the floppy disk drive containing the FP0779 disk and <destination> is the drive and directory where your FoxPro files are located.

   For example, if the FP0779 disk is in drive A, and your FoxPro directory is named FOXPRO25 and is on drive C, type the following command:

         copy a:\isdiskin.bin c:\foxpro25
   

To use ISDISKIN in a FoxPro program

1. If you are using FoxPro version 2.5 or later or the single-user version of FoxPro version 1.02 or 2.0, issue this command:

         SET DEFAULT TO <FoxPro directory>
   

   If you are using the multiuser version of FoxPro version 1.02 or 2.0, issue this command:

         SET DEFAULT TO C:\FOXPRO2\GOODIES\ADDUSER
   

2. Use the LOAD command to load the Isdiskin.bin file.

3. Create a character memory variable. Set the variable to the drive letter for the disk drive to test. For example, create a memory variable called <pvalue> and set it equal to "A:".

4. Use the CALL command to invoke the Isdiskin.bin file with the character memory variable as a parameter.

   Return value     Meaning
   ----------------------------------------------------------------------

   A:               Drive A tested and a disk is present in drive A.
   B:               Drive B tested and a disk is present in drive B.
   0: (zero)        No disk is present in the tested drive.

SAMPLE PROGRAM

   * If you are using the multiuser version of FoxPro 1.02 or 2.0, use
   * SET DEFAULT TO C:\FOXPRO2\GOODIES\ADDUSER instead of the
   * following line.
   SET DEFAULT TO <FoxPro directory>
   LOAD isdiskin.bin
   pvalue = "A:"
   CALL isdiskin.bin WITH pvalue
   DO CASE
   CASE pvalue = "A:"
      RUN DIR A:
   CASE pvalue = "0:"
      WAIT WINDOW "Please put a disk into drive A:"
   ENDCASE