isvirtual(PCI)                 6 January 1993                 isvirtual(PCI)


 Name

    isvirtual - return the virtual drive number of a specified path

 Syntax


    #include <pcilib.h>


    #include <memmdl.h>

    int isvirtual( dpath )
    char *dpath;


 Description

    isvirtual is a DOS function that returns the virtual drive number of the
    specified path.

    dpath is the DOS path name whose virtual drive location is to be deter-
    mined.  The pathname dpath need not refer to an existing file.

 Return value

    If the specified DOS path is found on a virtual drive, the drive number
    of the device is returned.  Drive A returns as 1, drive B returns as 2,
    and so forth.

    If the specified path is not on a virtual drive, a value of 0 returns.

 Example


               :
               :
       char *dPath = "D:\\DOS\\FILENAME";
       int  driveNum;
               :
               :

       /*
       ** Check if the DOS path name is
       ** on a virtual drive
       */
       if ( (driveNum = isvirtual(dPath)) == 0 )
            printf("%s is NOT on a virtual drive.\n", dPath);
       else
            printf("The DOS Drive Number for %s is: %d", dPath, driveNum);

               :
               :


 See also

    vdrive(PCI)