IFloppyImage Interface Reference

The IFloppyImage interface represents a file containing the image of a floppy disk. More...

List of all members.

Public Attributes

readonly attribute uuid id
 UUID of the floppy image.
readonly attribute wstring filePath
 Full file name of the floppy image.
readonly attribute boolean accessible
 Whether the floppy image is currently accessible or not.
readonly attribute unsigned long size
 Size of the floppy image in bytes.


Detailed Description

The IFloppyImage interface represents a file containing the image of a floppy disk.

Image Accessibility

The accessible attribute of the image object defines the accessibility state of the image file. If the value of this attribute is false then some image attributes may contain invalid or outdated values (for example, the the image file size) until a new accessibility check is done that returns true.

Note:
Because of the possible slowness of the accessibility check, it is not implicitly performed upon the VirtualBox server startup (to prevent the application freeze). In partcular, this means that if you try to read image properties that depend on the accessibility state without first reading the value of the accessible attribute and ensuring it's value is true, you will get wrong (zero) values.
Interface ID:
{CC696755-EA98-4FFE-9DC5-C003047034AB}

Member Data Documentation

readonly attribute uuid IFloppyImage::id

UUID of the floppy image.

readonly attribute wstring IFloppyImage::filePath

Full file name of the floppy image.

readonly attribute boolean IFloppyImage::accessible

Whether the floppy image is currently accessible or not.

The image, for example, can be unaccessible if it is placed on a network share that is not available by the time this property is read.

The accessibility check is performed automatically every time this attribute is read. You should keep it in mind that this check may be slow and can block the calling thread for a long time (for example, if the network share where the image is located is down).

The following attributes of the image object are considered to be invalid when this attribute is false:

readonly attribute unsigned long IFloppyImage::size

Size of the floppy image in bytes.


Generated on Fri Nov 21 21:38:41 2008 for VirtualBox Main API by  doxygen 1.5.5