System.Shell.Drive.isReady Property

Gets whether the system storage device is ready.

This property is read-only.

Syntax

propVal = System.Shell.Drive.isReady()

  

Parameters

• bDriveIsReady [out]
  Retrieves the ready-state.

  Value	Meaning
  true	The storage device is ready.
  false	The storage device is not ready.

   

Remarks

isReady returns true for removable media and CD-ROM drives when the storage media has been inserted and is ready for access.

Examples

The following example demonstrates how to get the ready-state of a storage device.

// --------------------------------------------------------------------
// Display drive information.
// driveLetter: user input.
// --------------------------------------------------------------------
function GetDriveInfo(driveLetter)
{
    var sDrive = "";
    var drive = System.Shell.drive(driveLetter);

    if (drive)
    {
        if (drive.isReady)
        {
            sDrive = "Label:" + drive.volumeLabel + " for drive(" + drive.driveLetter + ")<br/>";
            sDrive += "FreeSpace: " + drive.freeSpace + "MB<br/>";
            sDrive += "TotalFreeSpace: " + drive.totalFreeSpace + "MB<br/>";
            sDrive += "TotalSpace: " + drive.totalSize + "MB<br/>";
            sDrive += "DriveType: " + drive.driveType + "<br/>";
            sDrive += "DriveFormat: " + drive.driveFormat + "<br/>";
            sDrive += "RootDir: [" + drive.rootDirectory + "]<br/>";
        }
        else
        {
            sDrive = "Drive (" + driveLetter + ") is not ready.<br/>";
        }
    }
    else
    {
        sDrive = "Drive (" + driveLetter + ") is not valid.<br/>";
    }
    spFeedback.innerHTML = sDrive;
}

Requirements

See Also

System.Shell.Drive

System.Shell

Send comments about this topic to Microsoft

Build date: 2/24/2010

Build type: SDK