| 1388 | | The list of all <link to="IHardDisk2::format">storage formats</link> |
|---|
| 1389 | | supported by this VirtualBox installation can be obtained using |
|---|
| 1390 | | <link to="ISystemProperties::hardDiskFormats"/>. |
|---|
| | 1388 | The list of all storage formats supported by this VirtualBox |
|---|
| | 1389 | installation can be obtained using |
|---|
| | 1390 | <link to="ISystemProperties::hardDiskFormats"/>. If the @a format |
|---|
| | 1391 | attribute is empty or <tt>null</tt> then the default storage format |
|---|
| | 1392 | specified by <link to="ISystemProperties::defaultHardDiskFormat"/> will |
|---|
| | 1393 | be used for creating a storage unit of the hard disk. |
|---|
| | 5420 | </see> |
|---|
| | 5421 | </desc> |
|---|
| | 5422 | </attribute> |
|---|
| | 5423 | |
|---|
| | 5424 | <attribute name="defaultHardDiskFormat" type="wstring"> |
|---|
| | 5425 | <desc> |
|---|
| | 5426 | Identifier of the default hard disk format used by VirtualBox. |
|---|
| | 5427 | |
|---|
| | 5428 | The hard disk format set by this attribute is used by VirtualBox |
|---|
| | 5429 | when the hard disk format was not specified explicitly. One example is |
|---|
| | 5430 | <link to="IVirtualBox::createHardDisk2()"/> with the <tt>null</tt> |
|---|
| | 5431 | format argument. A more complex example is implicit creation of |
|---|
| | 5432 | differencing hard disks when taking a snapshot of a virtual machine: |
|---|
| | 5433 | this operation will try to use a format of the parent hard disk first |
|---|
| | 5434 | and if this format does not support differencing hard disks the default |
|---|
| | 5435 | format specified by this argument will be used. |
|---|
| | 5436 | |
|---|
| | 5437 | The list of supported hard disk formats may be obtained by the |
|---|
| | 5438 | <link to="#defaultHardDiskFormats"/> call. Note that the default |
|---|
| | 5439 | hard disk format must have a capability to create differencing hard |
|---|
| | 5440 | disks; otherwise opeartions that create hard disks implicitly may fail |
|---|
| | 5441 | unexpectedly. |
|---|
| | 5442 | |
|---|
| | 5443 | The initial value of this property is <tt>VDI</tt> in the current |
|---|
| | 5444 | version of the VirtualBox product, but may change in the future. |
|---|
| | 5445 | |
|---|
| | 5446 | <note> |
|---|
| | 5447 | Setting this property to <tt>null</tt> will restore the |
|---|
| | 5448 | initial value. |
|---|
| | 5449 | </note> |
|---|
| | 5450 | |
|---|
| | 5451 | <see> |
|---|
| | 5452 | <link to="#hardDiskFormats"/>, |
|---|
| | 5453 | <link to="IHardDiskFormat:id"/>, |
|---|
| | 5454 | <link to="IVirtualBox::createHardDisk2()"/> |
|---|
