org.virtualbox_6_1
Class ISystemProperties

java.lang.Object
  extended by org.virtualbox_6_1.IUnknown
      extended by org.virtualbox_6_1.ISystemProperties

public class ISystemProperties
extends IUnknown

The ISystemProperties interface represents global properties of the given VirtualBox installation. These properties define limits and default values for various attributes and parameters. Most of the properties are read-only, but some can be changed by a user. Interface ID: {027BC463-929C-40E8-BF16-FEA557CD8E7E}


Field Summary
 
Fields inherited from class org.virtualbox_6_1.IUnknown
obj, objMgr, port
 
Constructor Summary
ISystemProperties(java.lang.String wrapped, org.virtualbox_6_1.ObjectRefManager objMgr, org.virtualbox_6_1.jaxws.VboxPortType port)
           
 
Method Summary
 java.lang.String getAutostartDatabasePath()
          The path to the autostart database.
 java.lang.String getDefaultAdditionsISO()
          The path to the default Guest Additions ISO image.
 AudioDriverType getDefaultAudioDriver()
          This value hold the default audio driver for the current system.
 java.lang.String getDefaultFrontend()
          Selects which VM frontend should be used by default when launching a VM through theIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)method.
 java.lang.String getDefaultHardDiskFormat()
          Identifier of the default medium format used by VirtualBox.
 java.lang.Boolean getDefaultIoCacheSettingForStorageController(StorageControllerType controllerType)
          Returns the default I/O cache setting for the given storage controller
 java.lang.String getDefaultMachineFolder()
          Full path to the default directory used to create new or open existing machines when a machine settings file name contains no path.
 java.lang.String getDefaultVRDEExtPack()
          The name of the extension pack providing the default VRDE.
 java.util.List<DeviceType> getDeviceTypesForStorageBus(StorageBus bus)
          Returns list of all the supported device types (DeviceType) for the given type of storage bus.
 java.lang.Boolean getExclusiveHwVirt()
          Exclusive use of hardware virtualization by VirtualBox.
 java.lang.Long getFreeDiskSpaceError()
          Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.
 java.lang.Long getFreeDiskSpacePercentError()
          Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.
 java.lang.Long getFreeDiskSpacePercentWarning()
          Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.
 java.lang.Long getFreeDiskSpaceWarning()
          Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.
 java.lang.Long getInfoVDSize()
          Maximum size of a virtual disk image in bytes.
 java.lang.String getLoggingLevel()
          Specifies the logging level in current use by VirtualBox.
 java.lang.Long getLogHistoryCount()
          This value specifies how many old release log files are kept.
 java.lang.Long getMaxBootPosition()
          Maximum device position in the boot order.
 java.lang.Long getMaxDevicesPerPortForStorageBus(StorageBus bus)
          Returns the maximum number of devices which can be attached to a port for the given storage bus.
 java.lang.Long getMaxGuestCPUCount()
          Maximum CPU count.
 java.lang.Long getMaxGuestMonitors()
          Maximum of monitors which could be connected.
 java.lang.Long getMaxGuestRAM()
          Maximum guest system memory in Megabytes.
 java.lang.Long getMaxGuestVRAM()
          Maximum guest video memory in Megabytes.
 java.lang.Long getMaxInstancesOfStorageBus(ChipsetType chipset, StorageBus bus)
          Returns the maximum number of storage bus instances which can be configured for each VM.
 java.lang.Long getMaxInstancesOfUSBControllerType(ChipsetType chipset, USBControllerType type)
          Returns the maximum number of USB controller instances which can be configured for each VM.
 java.lang.Long getMaxNetworkAdapters(ChipsetType chipset)
          Maximum total number of network adapters associated with everyIMachineinstance.
 java.lang.Long getMaxNetworkAdaptersOfType(ChipsetType chipset, NetworkAttachmentType type)
          Maximum number of network adapters of a given attachment type, associated with everyIMachineinstance.
 java.lang.Long getMaxPortCountForStorageBus(StorageBus bus)
          Returns the maximum number of ports the given storage bus supports.
 java.util.List<IMediumFormat> getMediumFormats()
          List of all medium storage formats supported by this VirtualBox installation.
 java.lang.Long getMinGuestCPUCount()
          Minimum CPU count.
 java.lang.Long getMinGuestRAM()
          Minimum guest system memory in Megabytes.
 java.lang.Long getMinGuestVRAM()
          Minimum guest video memory in Megabytes.
 java.lang.Long getMinPortCountForStorageBus(StorageBus bus)
          Returns the minimum number of ports the given storage bus supports.
 java.lang.Long getParallelPortCount()
          Maximum number of parallel ports associated with everyIMachineinstance.
 ProxyMode getProxyMode()
          The proxy mode setting: System, NoProxy or Manual.
 java.lang.String getProxyURL()
          Proxy server URL for theProxyMode.Manualproxy mode.
 java.lang.Boolean getRawModeSupported()
          Indicates whether VirtualBox was built with raw-mode support.
 java.util.List<BitmapFormat> getScreenShotFormats()
          Supported bitmap formats which can be used with takeScreenShot and takeScreenShotToArray methods.
 java.lang.Long getSerialPortCount()
          Maximum number of serial ports associated with everyIMachineinstance.
 StorageBus getStorageBusForStorageControllerType(StorageControllerType storageControllerType)
          Returns theStorageBusenum value for a given storage controller type.
 java.lang.Boolean getStorageControllerHotplugCapable(StorageControllerType controllerType)
          Returns whether the given storage controller supports hot-plugging devices.
 java.util.List<StorageControllerType> getStorageControllerTypesForStorageBus(StorageBus storageBus)
          Returns the possibleStorageControllerTypeenum values for a given storage bus.
 java.util.List<AudioControllerType> getSupportedAudioControllerTypes()
          Returns an array of officially supported values for enumAudioControllerType, in the sense of what is e.g.
 java.util.List<AudioDriverType> getSupportedAudioDriverTypes()
          Returns an array of officially supported values for enumAudioDriverType, in the sense of what is e.g.
 java.util.List<AutostopType> getSupportedAutostopTypes()
          Returns an array of officially supported values for enumAutostopType, in the sense of what is e.g.
 java.util.List<ChipsetType> getSupportedChipsetTypes()
          Returns an array of officially supported values for enumChipsetType, in the sense of what is e.g.
 java.util.List<ClipboardMode> getSupportedClipboardModes()
          Returns an array of officially supported values for enumClipboardMode, in the sense of what is e.g.
 java.util.List<CloneOptions> getSupportedCloneOptions()
          Returns an array of officially supported values for enumCloneOptions, in the sense of what is e.g.
 java.util.List<DnDMode> getSupportedDnDModes()
          Returns an array of officially supported values for enumDnDMode, in the sense of what is e.g.
 java.util.List<ExportOptions> getSupportedExportOptions()
          Returns an array of officially supported values for enumExportOptions, in the sense of what is e.g.
 java.util.List<FirmwareType> getSupportedFirmwareTypes()
          Returns an array of officially supported values for enumFirmwareType, in the sense of what is e.g.
 java.util.List<GraphicsControllerType> getSupportedGraphicsControllerTypes()
          Returns an array of officially supported values for enumGraphicsControllerType, in the sense of what is e.g.
 java.util.List<ImportOptions> getSupportedImportOptions()
          Returns an array of officially supported values for enumImportOptions, in the sense of what is e.g.
 java.util.List<KeyboardHIDType> getSupportedKeyboardHIDTypes()
          Returns an array of officially supported values for enumKeyboardHIDType, in the sense of what is e.g.
 java.util.List<NetworkAdapterType> getSupportedNetworkAdapterTypes()
          Returns an array of officially supported values for enumNetworkAdapterType, in the sense of what is e.g.
 java.util.List<NetworkAttachmentType> getSupportedNetworkAttachmentTypes()
          Returns an array of officially supported values for enumNetworkAttachmentType, in the sense of what is e.g.
 java.util.List<ParavirtProvider> getSupportedParavirtProviders()
          Returns an array of officially supported values for enumParavirtProvider, in the sense of what is e.g.
 java.util.List<PointingHIDType> getSupportedPointingHIDTypes()
          Returns an array of officially supported values for enumPointingHIDType, in the sense of what is e.g.
 java.util.List<PortMode> getSupportedPortModes()
          Returns an array of officially supported values for enumPortMode, in the sense of what is e.g.
 java.util.List<RecordingAudioCodec> getSupportedRecordingAudioCodecs()
          Returns an array of officially supported values for enumRecordingAudioCodec, in the sense of what is e.g.
 java.util.List<RecordingVideoCodec> getSupportedRecordingVideoCodecs()
          Returns an array of officially supported values for enumRecordingVideoCodec, in the sense of what is e.g.
 java.util.List<RecordingVideoRateControlMode> getSupportedRecordingVRCModes()
          Returns an array of officially supported values for enumRecordingVideoRateControlMode, in the sense of what is e.g.
 java.util.List<RecordingVideoScalingMethod> getSupportedRecordingVSMethods()
          Returns an array of officially supported values for enumRecordingVideoScalingMethod, in the sense of what is e.g.
 java.util.List<StorageBus> getSupportedStorageBuses()
          Returns an array of officially supported values for enumStorageBus, in the sense of what is e.g.
 java.util.List<StorageControllerType> getSupportedStorageControllerTypes()
          Returns an array of officially supported values for enumStorageControllerType, in the sense of what is e.g.
 java.util.List<UartType> getSupportedUartTypes()
          Returns an array of officially supported values for enumUartType, in the sense of what is e.g.
 java.util.List<USBControllerType> getSupportedUSBControllerTypes()
          Returns an array of officially supported values for enumUSBControllerType, in the sense of what is e.g.
 java.util.List<VFSType> getSupportedVFSTypes()
          Returns an array of officially supported values for enumVFSType, in the sense of what is e.g.
 java.util.List<VMProcPriority> getSupportedVMProcPriorities()
          Returns an array of officially supported values for enumVMProcPriority, in the sense of what is e.g.
 java.lang.String getVRDEAuthLibrary()
          Library that provides authentication for Remote Desktop clients.
 java.lang.String getWebServiceAuthLibrary()
          Library that provides authentication for webservice clients.
static ISystemProperties queryInterface(IUnknown obj)
           
 void setAutostartDatabasePath(java.lang.String value)
          The path to the autostart database.
 void setDefaultAdditionsISO(java.lang.String value)
          The path to the default Guest Additions ISO image.
 void setDefaultFrontend(java.lang.String value)
          Selects which VM frontend should be used by default when launching a VM through theIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)method.
 void setDefaultHardDiskFormat(java.lang.String value)
          Identifier of the default medium format used by VirtualBox.
 void setDefaultMachineFolder(java.lang.String value)
          Full path to the default directory used to create new or open existing machines when a machine settings file name contains no path.
 void setDefaultVRDEExtPack(java.lang.String value)
          The name of the extension pack providing the default VRDE.
 void setExclusiveHwVirt(java.lang.Boolean value)
          Exclusive use of hardware virtualization by VirtualBox.
 void setFreeDiskSpaceError(java.lang.Long value)
          Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.
 void setFreeDiskSpacePercentError(java.lang.Long value)
          Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.
 void setFreeDiskSpacePercentWarning(java.lang.Long value)
          Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.
 void setFreeDiskSpaceWarning(java.lang.Long value)
          Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.
 void setLoggingLevel(java.lang.String value)
          Specifies the logging level in current use by VirtualBox.
 void setLogHistoryCount(java.lang.Long value)
          This value specifies how many old release log files are kept.
 void setProxyMode(ProxyMode value)
          The proxy mode setting: System, NoProxy or Manual.
 void setProxyURL(java.lang.String value)
          Proxy server URL for theProxyMode.Manualproxy mode.
 void setVRDEAuthLibrary(java.lang.String value)
          Library that provides authentication for Remote Desktop clients.
 void setWebServiceAuthLibrary(java.lang.String value)
          Library that provides authentication for webservice clients.
 
Methods inherited from class org.virtualbox_6_1.IUnknown
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

ISystemProperties

public ISystemProperties(java.lang.String wrapped,
                         org.virtualbox_6_1.ObjectRefManager objMgr,
                         org.virtualbox_6_1.jaxws.VboxPortType port)
Method Detail

getMinGuestRAM

public java.lang.Long getMinGuestRAM()
Minimum guest system memory in Megabytes.

Returns:
Long

getMaxGuestRAM

public java.lang.Long getMaxGuestRAM()
Maximum guest system memory in Megabytes.

Returns:
Long

getMinGuestVRAM

public java.lang.Long getMinGuestVRAM()
Minimum guest video memory in Megabytes.

Returns:
Long

getMaxGuestVRAM

public java.lang.Long getMaxGuestVRAM()
Maximum guest video memory in Megabytes.

Returns:
Long

getMinGuestCPUCount

public java.lang.Long getMinGuestCPUCount()
Minimum CPU count.

Returns:
Long

getMaxGuestCPUCount

public java.lang.Long getMaxGuestCPUCount()
Maximum CPU count.

Returns:
Long

getMaxGuestMonitors

public java.lang.Long getMaxGuestMonitors()
Maximum of monitors which could be connected.

Returns:
Long

getInfoVDSize

public java.lang.Long getInfoVDSize()
Maximum size of a virtual disk image in bytes. Informational value, does not reflect the limits of any virtual disk image format.

Returns:
Long

getSerialPortCount

public java.lang.Long getSerialPortCount()
Maximum number of serial ports associated with everyIMachineinstance.

Returns:
Long

getParallelPortCount

public java.lang.Long getParallelPortCount()
Maximum number of parallel ports associated with everyIMachineinstance.

Returns:
Long

getMaxBootPosition

public java.lang.Long getMaxBootPosition()
Maximum device position in the boot order. This value corresponds to the total number of devices a machine can boot from, to make it possible to include all possible devices to the boot list.

Returns:
Long
See Also:
IMachine.setBootOrder(Long,org.virtualbox_6_1.DeviceType)

getRawModeSupported

public java.lang.Boolean getRawModeSupported()
Indicates whether VirtualBox was built with raw-mode support. When this reads as False, theHWVirtExPropertyType.Enabledsetting will be ignored and assumed to be True.

Returns:
Boolean

getExclusiveHwVirt

public java.lang.Boolean getExclusiveHwVirt()
Exclusive use of hardware virtualization by VirtualBox. When enabled, VirtualBox assumes it can obtain full and exclusive access to the VT-x or AMD-V feature of the host. To share hardware virtualization with other hypervisors, this property must be disabled. NOTE: This is ignored on OS X, the kernel mediates hardware access there.

Returns:
Boolean

setExclusiveHwVirt

public void setExclusiveHwVirt(java.lang.Boolean value)
Exclusive use of hardware virtualization by VirtualBox. When enabled, VirtualBox assumes it can obtain full and exclusive access to the VT-x or AMD-V feature of the host. To share hardware virtualization with other hypervisors, this property must be disabled. NOTE: This is ignored on OS X, the kernel mediates hardware access there.

Parameters:
value - Boolean

getDefaultMachineFolder

public java.lang.String getDefaultMachineFolder()
Full path to the default directory used to create new or open existing machines when a machine settings file name contains no path. Starting with VirtualBox 4.0, by default, this attribute contains the full path of folder named "VirtualBox VMs" in the user's home directory, which depends on the host platform. When setting this attribute, a full path must be specified. Setting this property to null or an empty string or the special value "Machines" (for compatibility reasons) will restore that default value. If the folder specified herein does not exist, it will be created automatically as needed.

Returns:
String
See Also:
IVirtualBox.createMachine(String,String,List,String,String), IVirtualBox.openMachine(String)

setDefaultMachineFolder

public void setDefaultMachineFolder(java.lang.String value)
Full path to the default directory used to create new or open existing machines when a machine settings file name contains no path. Starting with VirtualBox 4.0, by default, this attribute contains the full path of folder named "VirtualBox VMs" in the user's home directory, which depends on the host platform. When setting this attribute, a full path must be specified. Setting this property to null or an empty string or the special value "Machines" (for compatibility reasons) will restore that default value. If the folder specified herein does not exist, it will be created automatically as needed.

Parameters:
value - String
See Also:
IVirtualBox.createMachine(String,String,List,String,String), IVirtualBox.openMachine(String)

getLoggingLevel

public java.lang.String getLoggingLevel()
Specifies the logging level in current use by VirtualBox.

Returns:
String

setLoggingLevel

public void setLoggingLevel(java.lang.String value)
Specifies the logging level in current use by VirtualBox.

Parameters:
value - String

getMediumFormats

public java.util.List<IMediumFormat> getMediumFormats()
List of all medium storage formats supported by this VirtualBox installation. Keep in mind that the medium format identifier (IMediumFormat.getId()) used in other API calls likeIVirtualBox.createMedium(String,String,org.virtualbox_6_1.AccessMode,org.virtualbox_6_1.DeviceType)to refer to a particular medium format is a case-insensitive string. This means that, for example, all of the following strings:
"VDI"
"vdi"
"VdI"
refer to the same medium format. Note that the virtual medium framework is backend-based, therefore the list of supported formats depends on what backends are currently installed.

Returns:
List<org.virtualbox_6_1.IMediumFormat>
See Also:
IMediumFormat

getDefaultHardDiskFormat

public java.lang.String getDefaultHardDiskFormat()
Identifier of the default medium format used by VirtualBox. The medium format set by this attribute is used by VirtualBox when the medium format was not specified explicitly. One example isIVirtualBox.createMedium(String,String,org.virtualbox_6_1.AccessMode,org.virtualbox_6_1.DeviceType)with the empty format argument. A more complex example is implicit creation of differencing media when taking a snapshot of a virtual machine: this operation will try to use a format of the parent medium first and if this format does not support differencing media the default format specified by this argument will be used. The list of supported medium formats may be obtained by thegetMediumFormats()call. Note that the default medium format must have a capability to create differencing media; otherwise operations that create media implicitly may fail unexpectedly. The initial value of this property is"VDI"in the current version of the VirtualBox product, but may change in the future. NOTE: Setting this property to null or empty string will restore the initial value.

Returns:
String
See Also:
getMediumFormats(), IMediumFormat.getId(), IVirtualBox.createMedium(String,String,org.virtualbox_6_1.AccessMode,org.virtualbox_6_1.DeviceType)

setDefaultHardDiskFormat

public void setDefaultHardDiskFormat(java.lang.String value)
Identifier of the default medium format used by VirtualBox. The medium format set by this attribute is used by VirtualBox when the medium format was not specified explicitly. One example isIVirtualBox.createMedium(String,String,org.virtualbox_6_1.AccessMode,org.virtualbox_6_1.DeviceType)with the empty format argument. A more complex example is implicit creation of differencing media when taking a snapshot of a virtual machine: this operation will try to use a format of the parent medium first and if this format does not support differencing media the default format specified by this argument will be used. The list of supported medium formats may be obtained by thegetMediumFormats()call. Note that the default medium format must have a capability to create differencing media; otherwise operations that create media implicitly may fail unexpectedly. The initial value of this property is"VDI"in the current version of the VirtualBox product, but may change in the future. NOTE: Setting this property to null or empty string will restore the initial value.

Parameters:
value - String
See Also:
getMediumFormats(), IMediumFormat.getId(), IVirtualBox.createMedium(String,String,org.virtualbox_6_1.AccessMode,org.virtualbox_6_1.DeviceType)

getFreeDiskSpaceWarning

public java.lang.Long getFreeDiskSpaceWarning()
Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.

Returns:
Long

setFreeDiskSpaceWarning

public void setFreeDiskSpaceWarning(java.lang.Long value)
Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.

Parameters:
value - Long

getFreeDiskSpacePercentWarning

public java.lang.Long getFreeDiskSpacePercentWarning()
Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.

Returns:
Long

setFreeDiskSpacePercentWarning

public void setFreeDiskSpacePercentWarning(java.lang.Long value)
Issue a warning if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.

Parameters:
value - Long

getFreeDiskSpaceError

public java.lang.Long getFreeDiskSpaceError()
Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.

Returns:
Long

setFreeDiskSpaceError

public void setFreeDiskSpaceError(java.lang.Long value)
Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given size in bytes.

Parameters:
value - Long

getFreeDiskSpacePercentError

public java.lang.Long getFreeDiskSpacePercentError()
Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.

Returns:
Long

setFreeDiskSpacePercentError

public void setFreeDiskSpacePercentError(java.lang.Long value)
Issue an error if the free disk space is below (or in some disk intensive operation is expected to go below) the given percentage.

Parameters:
value - Long

getVRDEAuthLibrary

public java.lang.String getVRDEAuthLibrary()
Library that provides authentication for Remote Desktop clients. The library is used if a virtual machine's authentication type is set to "external" in the VM RemoteDisplay configuration. The system library extension (".DLL" or ".so") must be omitted. A full path can be specified; if not, then the library must reside on the system's default library path. The default value of this property is"VBoxAuth". There is a library of that name in one of the default VirtualBox library directories. For details about VirtualBox authentication libraries and how to implement them, please refer to the VirtualBox manual. NOTE: Setting this property to null or empty string will restore the initial value.

Returns:
String

setVRDEAuthLibrary

public void setVRDEAuthLibrary(java.lang.String value)
Library that provides authentication for Remote Desktop clients. The library is used if a virtual machine's authentication type is set to "external" in the VM RemoteDisplay configuration. The system library extension (".DLL" or ".so") must be omitted. A full path can be specified; if not, then the library must reside on the system's default library path. The default value of this property is"VBoxAuth". There is a library of that name in one of the default VirtualBox library directories. For details about VirtualBox authentication libraries and how to implement them, please refer to the VirtualBox manual. NOTE: Setting this property to null or empty string will restore the initial value.

Parameters:
value - String

getWebServiceAuthLibrary

public java.lang.String getWebServiceAuthLibrary()
Library that provides authentication for webservice clients. The library is used if a virtual machine's authentication type is set to "external" in the VM RemoteDisplay configuration and will be called from within theIWebsessionManager.logon(String,String)implementation. As opposed togetVRDEAuthLibrary(), there is no per-VM setting for this, as the webservice is a global resource (if it is running). Only for this setting (for the webservice), setting this value to a literal"null"string disables authentication, meaning thatIWebsessionManager.logon(String,String)will always succeed, no matter what user name and password are supplied. The initial value of this property is"VBoxAuth", meaning that the webservice will use the same authentication library that is used by default for VRDE (again, seegetVRDEAuthLibrary()). The format and calling convention of authentication libraries is the same for the webservice as it is for VRDE. NOTE: Setting this property to null or empty string will restore the initial value.

Returns:
String

setWebServiceAuthLibrary

public void setWebServiceAuthLibrary(java.lang.String value)
Library that provides authentication for webservice clients. The library is used if a virtual machine's authentication type is set to "external" in the VM RemoteDisplay configuration and will be called from within theIWebsessionManager.logon(String,String)implementation. As opposed togetVRDEAuthLibrary(), there is no per-VM setting for this, as the webservice is a global resource (if it is running). Only for this setting (for the webservice), setting this value to a literal"null"string disables authentication, meaning thatIWebsessionManager.logon(String,String)will always succeed, no matter what user name and password are supplied. The initial value of this property is"VBoxAuth", meaning that the webservice will use the same authentication library that is used by default for VRDE (again, seegetVRDEAuthLibrary()). The format and calling convention of authentication libraries is the same for the webservice as it is for VRDE. NOTE: Setting this property to null or empty string will restore the initial value.

Parameters:
value - String

getDefaultVRDEExtPack

public java.lang.String getDefaultVRDEExtPack()
The name of the extension pack providing the default VRDE. This attribute is for choosing between multiple extension packs providing VRDE. If only one is installed, it will automatically be the default one. The attribute value can be empty if no VRDE extension pack is installed. For details about VirtualBox Remote Desktop Extension and how to implement one, please refer to the VirtualBox SDK.

Returns:
String

setDefaultVRDEExtPack

public void setDefaultVRDEExtPack(java.lang.String value)
The name of the extension pack providing the default VRDE. This attribute is for choosing between multiple extension packs providing VRDE. If only one is installed, it will automatically be the default one. The attribute value can be empty if no VRDE extension pack is installed. For details about VirtualBox Remote Desktop Extension and how to implement one, please refer to the VirtualBox SDK.

Parameters:
value - String

getLogHistoryCount

public java.lang.Long getLogHistoryCount()
This value specifies how many old release log files are kept.

Returns:
Long

setLogHistoryCount

public void setLogHistoryCount(java.lang.Long value)
This value specifies how many old release log files are kept.

Parameters:
value - Long

getDefaultAudioDriver

public AudioDriverType getDefaultAudioDriver()
This value hold the default audio driver for the current system.

Returns:
org.virtualbox_6_1.AudioDriverType

getAutostartDatabasePath

public java.lang.String getAutostartDatabasePath()
The path to the autostart database. Depending on the host this might be a filesystem path or something else.

Returns:
String

setAutostartDatabasePath

public void setAutostartDatabasePath(java.lang.String value)
The path to the autostart database. Depending on the host this might be a filesystem path or something else.

Parameters:
value - String

getDefaultAdditionsISO

public java.lang.String getDefaultAdditionsISO()
The path to the default Guest Additions ISO image. Can be empty if the location is not known in this installation.

Returns:
String

setDefaultAdditionsISO

public void setDefaultAdditionsISO(java.lang.String value)
The path to the default Guest Additions ISO image. Can be empty if the location is not known in this installation.

Parameters:
value - String

getDefaultFrontend

public java.lang.String getDefaultFrontend()
Selects which VM frontend should be used by default when launching a VM through theIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)method. Empty or null strings do not define a particular default, it is up toIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)to select one. See the description ofIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)for the valid frontend types. This global setting is overridden by the per-VM attributeIMachine.getDefaultFrontend()or a frontend type passed toIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List).

Returns:
String

setDefaultFrontend

public void setDefaultFrontend(java.lang.String value)
Selects which VM frontend should be used by default when launching a VM through theIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)method. Empty or null strings do not define a particular default, it is up toIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)to select one. See the description ofIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List)for the valid frontend types. This global setting is overridden by the per-VM attributeIMachine.getDefaultFrontend()or a frontend type passed toIMachine.launchVMProcess(org.virtualbox_6_1.ISession,String,List).

Parameters:
value - String

getScreenShotFormats

public java.util.List<BitmapFormat> getScreenShotFormats()
Supported bitmap formats which can be used with takeScreenShot and takeScreenShotToArray methods.

Returns:
List<org.virtualbox_6_1.BitmapFormat>

getProxyMode

public ProxyMode getProxyMode()
The proxy mode setting: System, NoProxy or Manual.

Returns:
org.virtualbox_6_1.ProxyMode

setProxyMode

public void setProxyMode(ProxyMode value)
The proxy mode setting: System, NoProxy or Manual.

Parameters:
value - org.virtualbox_6_1.ProxyMode

getProxyURL

public java.lang.String getProxyURL()
Proxy server URL for theProxyMode.Manualproxy mode. The format is: [{type}"://"][{userid}[@{password}]:]{server}[":"{port}] Valid types are: http (default), https, socks4, socks4a, socks5, socks5h and direct. Please note that these are proxy types defining how the proxy operates rather than how to proxy any similarly named protocol (i.e. don't confuse a http-proxy with proxying the http protocol, as a http-proxy usually can proxy https and other protocols too). The port number defaults to 80 for http, 443 for https and 1080 for the socks ones.An empty string will cause the behavior to be identical toProxyMode.System. For compatibility with libproxy, an URL starting with "direct://" will causeProxyMode.NoProxybehavior. NOTE: The password is currently stored as plain text! Use theProxyMode.Systemmode if you consider the proxy password to be sensitive.

Returns:
String

setProxyURL

public void setProxyURL(java.lang.String value)
Proxy server URL for theProxyMode.Manualproxy mode. The format is: [{type}"://"][{userid}[@{password}]:]{server}[":"{port}] Valid types are: http (default), https, socks4, socks4a, socks5, socks5h and direct. Please note that these are proxy types defining how the proxy operates rather than how to proxy any similarly named protocol (i.e. don't confuse a http-proxy with proxying the http protocol, as a http-proxy usually can proxy https and other protocols too). The port number defaults to 80 for http, 443 for https and 1080 for the socks ones.An empty string will cause the behavior to be identical toProxyMode.System. For compatibility with libproxy, an URL starting with "direct://" will causeProxyMode.NoProxybehavior. NOTE: The password is currently stored as plain text! Use theProxyMode.Systemmode if you consider the proxy password to be sensitive.

Parameters:
value - String

getSupportedParavirtProviders

public java.util.List<ParavirtProvider> getSupportedParavirtProviders()
Returns an array of officially supported values for enumParavirtProvider, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.ParavirtProvider>

getSupportedClipboardModes

public java.util.List<ClipboardMode> getSupportedClipboardModes()
Returns an array of officially supported values for enumClipboardMode, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.ClipboardMode>

getSupportedDnDModes

public java.util.List<DnDMode> getSupportedDnDModes()
Returns an array of officially supported values for enumDnDMode, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.DnDMode>

getSupportedFirmwareTypes

public java.util.List<FirmwareType> getSupportedFirmwareTypes()
Returns an array of officially supported values for enumFirmwareType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.FirmwareType>

getSupportedPointingHIDTypes

public java.util.List<PointingHIDType> getSupportedPointingHIDTypes()
Returns an array of officially supported values for enumPointingHIDType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.PointingHIDType>

getSupportedKeyboardHIDTypes

public java.util.List<KeyboardHIDType> getSupportedKeyboardHIDTypes()
Returns an array of officially supported values for enumKeyboardHIDType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.KeyboardHIDType>

getSupportedVFSTypes

public java.util.List<VFSType> getSupportedVFSTypes()
Returns an array of officially supported values for enumVFSType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.VFSType>

getSupportedImportOptions

public java.util.List<ImportOptions> getSupportedImportOptions()
Returns an array of officially supported values for enumImportOptions, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.ImportOptions>

getSupportedExportOptions

public java.util.List<ExportOptions> getSupportedExportOptions()
Returns an array of officially supported values for enumExportOptions, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.ExportOptions>

getSupportedRecordingAudioCodecs

public java.util.List<RecordingAudioCodec> getSupportedRecordingAudioCodecs()
Returns an array of officially supported values for enumRecordingAudioCodec, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.RecordingAudioCodec>

getSupportedRecordingVideoCodecs

public java.util.List<RecordingVideoCodec> getSupportedRecordingVideoCodecs()
Returns an array of officially supported values for enumRecordingVideoCodec, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.RecordingVideoCodec>

getSupportedRecordingVSMethods

public java.util.List<RecordingVideoScalingMethod> getSupportedRecordingVSMethods()
Returns an array of officially supported values for enumRecordingVideoScalingMethod, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.RecordingVideoScalingMethod>

getSupportedRecordingVRCModes

public java.util.List<RecordingVideoRateControlMode> getSupportedRecordingVRCModes()
Returns an array of officially supported values for enumRecordingVideoRateControlMode, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.RecordingVideoRateControlMode>

getSupportedGraphicsControllerTypes

public java.util.List<GraphicsControllerType> getSupportedGraphicsControllerTypes()
Returns an array of officially supported values for enumGraphicsControllerType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.GraphicsControllerType>

getSupportedCloneOptions

public java.util.List<CloneOptions> getSupportedCloneOptions()
Returns an array of officially supported values for enumCloneOptions, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.CloneOptions>

getSupportedAutostopTypes

public java.util.List<AutostopType> getSupportedAutostopTypes()
Returns an array of officially supported values for enumAutostopType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.AutostopType>

getSupportedVMProcPriorities

public java.util.List<VMProcPriority> getSupportedVMProcPriorities()
Returns an array of officially supported values for enumVMProcPriority, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.VMProcPriority>

getSupportedNetworkAttachmentTypes

public java.util.List<NetworkAttachmentType> getSupportedNetworkAttachmentTypes()
Returns an array of officially supported values for enumNetworkAttachmentType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.NetworkAttachmentType>

getSupportedNetworkAdapterTypes

public java.util.List<NetworkAdapterType> getSupportedNetworkAdapterTypes()
Returns an array of officially supported values for enumNetworkAdapterType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.NetworkAdapterType>

getSupportedPortModes

public java.util.List<PortMode> getSupportedPortModes()
Returns an array of officially supported values for enumPortMode, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.PortMode>

getSupportedUartTypes

public java.util.List<UartType> getSupportedUartTypes()
Returns an array of officially supported values for enumUartType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.UartType>

getSupportedUSBControllerTypes

public java.util.List<USBControllerType> getSupportedUSBControllerTypes()
Returns an array of officially supported values for enumUSBControllerType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.USBControllerType>

getSupportedAudioDriverTypes

public java.util.List<AudioDriverType> getSupportedAudioDriverTypes()
Returns an array of officially supported values for enumAudioDriverType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.AudioDriverType>

getSupportedAudioControllerTypes

public java.util.List<AudioControllerType> getSupportedAudioControllerTypes()
Returns an array of officially supported values for enumAudioControllerType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.AudioControllerType>

getSupportedStorageBuses

public java.util.List<StorageBus> getSupportedStorageBuses()
Returns an array of officially supported values for enumStorageBus, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.StorageBus>

getSupportedStorageControllerTypes

public java.util.List<StorageControllerType> getSupportedStorageControllerTypes()
Returns an array of officially supported values for enumStorageControllerType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.StorageControllerType>

getSupportedChipsetTypes

public java.util.List<ChipsetType> getSupportedChipsetTypes()
Returns an array of officially supported values for enumChipsetType, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_6_1.ChipsetType>

queryInterface

public static ISystemProperties queryInterface(IUnknown obj)

getMaxNetworkAdapters

public java.lang.Long getMaxNetworkAdapters(ChipsetType chipset)
Maximum total number of network adapters associated with everyIMachineinstance.

Parameters:
chipset - The chipset type to get the value for.
Returns:
The maximum total number of network adapters allowed.

getMaxNetworkAdaptersOfType

public java.lang.Long getMaxNetworkAdaptersOfType(ChipsetType chipset,
                                                  NetworkAttachmentType type)
Maximum number of network adapters of a given attachment type, associated with everyIMachineinstance.

Parameters:
chipset - The chipset type to get the value for.
type - Type of attachment.
Returns:
The maximum number of network adapters allowed for particular chipset and attachment type.

getMaxDevicesPerPortForStorageBus

public java.lang.Long getMaxDevicesPerPortForStorageBus(StorageBus bus)
Returns the maximum number of devices which can be attached to a port for the given storage bus.

Parameters:
bus - The storage bus type to get the value for.
Returns:
The maximum number of devices which can be attached to the port for the given storage bus.

getMinPortCountForStorageBus

public java.lang.Long getMinPortCountForStorageBus(StorageBus bus)
Returns the minimum number of ports the given storage bus supports.

Parameters:
bus - The storage bus type to get the value for.
Returns:
The minimum number of ports for the given storage bus.

getMaxPortCountForStorageBus

public java.lang.Long getMaxPortCountForStorageBus(StorageBus bus)
Returns the maximum number of ports the given storage bus supports.

Parameters:
bus - The storage bus type to get the value for.
Returns:
The maximum number of ports for the given storage bus.

getMaxInstancesOfStorageBus

public java.lang.Long getMaxInstancesOfStorageBus(ChipsetType chipset,
                                                  StorageBus bus)
Returns the maximum number of storage bus instances which can be configured for each VM. This corresponds to the number of storage controllers one can have. Value may depend on chipset type used.

Parameters:
chipset - The chipset type to get the value for.
bus - The storage bus type to get the value for.
Returns:
The maximum number of instances for the given storage bus.

getDeviceTypesForStorageBus

public java.util.List<DeviceType> getDeviceTypesForStorageBus(StorageBus bus)
Returns list of all the supported device types (DeviceType) for the given type of storage bus.

Parameters:
bus - The storage bus type to get the value for.
Returns:
The list of all supported device types for the given storage bus.

getStorageBusForStorageControllerType

public StorageBus getStorageBusForStorageControllerType(StorageControllerType storageControllerType)
Returns theStorageBusenum value for a given storage controller type.

Parameters:
storageControllerType - The storage controller type to get the value for.
Returns:
The storage bus which is applicable.

getStorageControllerTypesForStorageBus

public java.util.List<StorageControllerType> getStorageControllerTypesForStorageBus(StorageBus storageBus)
Returns the possibleStorageControllerTypeenum values for a given storage bus.

Parameters:
storageBus - The storage bus type to get the values for.
Returns:
The enum values (sorted by what should be a sensible decreasing importance of the type) which are valid.

getDefaultIoCacheSettingForStorageController

public java.lang.Boolean getDefaultIoCacheSettingForStorageController(StorageControllerType controllerType)
Returns the default I/O cache setting for the given storage controller

Parameters:
controllerType - The storage controller type to get the setting for.
Returns:
Returned flag indicating the default value

getStorageControllerHotplugCapable

public java.lang.Boolean getStorageControllerHotplugCapable(StorageControllerType controllerType)
Returns whether the given storage controller supports hot-plugging devices.

Parameters:
controllerType - The storage controller to check the setting for.
Returns:
Returned flag indicating whether the controller is hotplug capable

getMaxInstancesOfUSBControllerType

public java.lang.Long getMaxInstancesOfUSBControllerType(ChipsetType chipset,
                                                         USBControllerType type)
Returns the maximum number of USB controller instances which can be configured for each VM. This corresponds to the number of USB controllers one can have. Value may depend on chipset type used.

Parameters:
chipset - The chipset type to get the value for.
type - The USB controller type to get the value for.
Returns:
The maximum number of instances for the given USB controller type.