System.Shell.Drive.isReady property
[ The Windows Gadget Platform/Sidebar is available for use in the operating systems specified in the Requirements section. It may be altered or unavailable in subsequent versions. ]
Gets whether the system storage device is ready.
This property is read-only.
Syntax
bisReady = System.Shell.Drive.isReady
Property value
A Boolean that receives the ready-state.
(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
Minimum supported client |
Windows Vista [desktop apps only] |
Minimum supported server |
Windows Server 2008 [desktop apps only] |
End of client support |
Windows 7 |
End of server support |
Windows Server 2008 |
IDL |
|
DLL |
|