org.virtualbox_7_1
Class ISystemProperties

java.lang.Object
  extended by org.virtualbox_7_1.IUnknown
      extended by org.virtualbox_7_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: {C61E666E-34AB-403A-8160-78BD4512CA86}


Field Summary
 
Fields inherited from class org.virtualbox_7_1.IUnknown
obj, objMgr, port
 
Constructor Summary
ISystemProperties(java.lang.String wrapped, org.virtualbox_7_1.ObjectRefManager objMgr, org.virtualbox_7_1.jaxws.VboxPortType port)
           
 
Method Summary
 java.lang.String getAutostartDatabasePath()
          The path to the autostart database.
 java.util.List<ICPUProfile> getCPUProfiles(CPUArchitecture architecture, java.lang.String namePattern)
          Returns CPU profiles matching the given criteria.
 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 getDefaultCryptoExtPack()
          The name of the extension pack providing the default cryptographic support for full VM encryption.
 java.lang.String getDefaultFrontend()
          Selects which VM frontend should be used by default when launching a VM through theIMachine.launchVMProcess(org.virtualbox_7_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<VMExecutionEngine> getExecutionEnginesForVmCpuArchitecture(CPUArchitecture cpuArchitecture)
          Returns the possibleVMExecutionEngineenum values for a given VM CPU architecture.
 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 getLanguageId()
          The API language ID used to translate messages to client.
 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 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.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.
 IPlatformProperties getPlatform()
          Platform properties of the VirtualBox installation.
 ProxyMode getProxyMode()
          The proxy mode setting: System, NoProxy or Manual.
 java.lang.String getProxyURL()
          Proxy server URL for theProxyMode.Manualproxy mode.
 java.util.List<BitmapFormat> getScreenShotFormats()
          Supported bitmap formats which can be used with takeScreenShot and takeScreenShotToArray methods.
 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<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<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<NetworkAttachmentType> getSupportedNetworkAttachmentTypes()
          Returns an array of officially supported values for enumNetworkAttachmentType, in the sense of what is e.g.
 java.util.List<PlatformArchitecture> getSupportedPlatformArchitectures()
          Returns an array of officially supported values for enumPlatformArchitecture, 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<RecordingRateControlMode> getSupportedRecordingARCModes()
          Returns an array of officially supported audio codec values for enumRecordingRateControlMode, 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<RecordingFeature> getSupportedRecordingFeatures()
          Returns an array of officially supported values for enumRecordingFeature, 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<RecordingRateControlMode> getSupportedRecordingVRCModes()
          Returns an array of officially supported video codec values for enumRecordingRateControlMode, in the sense of what is e.g.
 java.util.List<RecordingVideoScalingMode> getSupportedRecordingVSModes()
          Returns an array of officially supported values for enumRecordingVideoScalingMode, 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 setDefaultCryptoExtPack(java.lang.String value)
          The name of the extension pack providing the default cryptographic support for full VM encryption.
 void setDefaultFrontend(java.lang.String value)
          Selects which VM frontend should be used by default when launching a VM through theIMachine.launchVMProcess(org.virtualbox_7_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 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 setLanguageId(java.lang.String value)
          The API language ID used to translate messages to client.
 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_7_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_7_1.ObjectRefManager objMgr,
                         org.virtualbox_7_1.jaxws.VboxPortType port)
Method Detail

getPlatform

public IPlatformProperties getPlatform()
Platform properties of the VirtualBox installation.

Returns:
org.virtualbox_7_1.IPlatformProperties

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

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,org.virtualbox_7_1.PlatformArchitecture,List,String,String,String,String,String), IVirtualBox.openMachine(String,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,org.virtualbox_7_1.PlatformArchitecture,List,String,String,String,String,String), IVirtualBox.openMachine(String,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_7_1.AccessMode,org.virtualbox_7_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_7_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_7_1.AccessMode,org.virtualbox_7_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_7_1.AccessMode,org.virtualbox_7_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_7_1.AccessMode,org.virtualbox_7_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_7_1.AccessMode,org.virtualbox_7_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

getDefaultCryptoExtPack

public java.lang.String getDefaultCryptoExtPack()
The name of the extension pack providing the default cryptographic support for full VM encryption. This attribute is for choosing between multiple extension packs providing cryptographic support. If only one is installed, it will automatically be the default one. The attribute value can be empty if no cryptographic extension pack is installed.

Returns:
String

setDefaultCryptoExtPack

public void setDefaultCryptoExtPack(java.lang.String value)
The name of the extension pack providing the default cryptographic support for full VM encryption. This attribute is for choosing between multiple extension packs providing cryptographic support. If only one is installed, it will automatically be the default one. The attribute value can be empty if no cryptographic extension pack is installed.

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_7_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_7_1.ISession,String,List)method. Empty or null strings do not define a particular default, it is up toIMachine.launchVMProcess(org.virtualbox_7_1.ISession,String,List)to select one. See the description ofIMachine.launchVMProcess(org.virtualbox_7_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_7_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_7_1.ISession,String,List)method. Empty or null strings do not define a particular default, it is up toIMachine.launchVMProcess(org.virtualbox_7_1.ISession,String,List)to select one. See the description ofIMachine.launchVMProcess(org.virtualbox_7_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_7_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_7_1.BitmapFormat>

getProxyMode

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

Returns:
org.virtualbox_7_1.ProxyMode

setProxyMode

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

Parameters:
value - org.virtualbox_7_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

getSupportedPlatformArchitectures

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

Returns:
List<org.virtualbox_7_1.PlatformArchitecture>

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_7_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_7_1.DnDMode>

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_7_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_7_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_7_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_7_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_7_1.ExportOptions>

getSupportedRecordingFeatures

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

Returns:
List<org.virtualbox_7_1.RecordingFeature>

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_7_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_7_1.RecordingVideoCodec>

getSupportedRecordingVSModes

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

Returns:
List<org.virtualbox_7_1.RecordingVideoScalingMode>

getSupportedRecordingARCModes

public java.util.List<RecordingRateControlMode> getSupportedRecordingARCModes()
Returns an array of officially supported audio codec values for enumRecordingRateControlMode, in the sense of what is e.g. worth offering in the VirtualBox GUI.

Returns:
List<org.virtualbox_7_1.RecordingRateControlMode>

getSupportedRecordingVRCModes

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

Returns:
List<org.virtualbox_7_1.RecordingRateControlMode>

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_7_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_7_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_7_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_7_1.NetworkAttachmentType>

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_7_1.PortMode>

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_7_1.AudioDriverType>

getLanguageId

public java.lang.String getLanguageId()
The API language ID used to translate messages to client.

Returns:
String

setLanguageId

public void setLanguageId(java.lang.String value)
The API language ID used to translate messages to client.

Parameters:
value - String

queryInterface

public static ISystemProperties queryInterface(IUnknown obj)

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

getCPUProfiles

public java.util.List<ICPUProfile> getCPUProfiles(CPUArchitecture architecture,
                                                  java.lang.String namePattern)
Returns CPU profiles matching the given criteria.

Parameters:
architecture - The architecture to get profiles for. Required.
namePattern - Name pattern. Simple wildcard matching using asterisk (*) and question mark (?).
Returns:
The matching CPU profiles.

getExecutionEnginesForVmCpuArchitecture

public java.util.List<VMExecutionEngine> getExecutionEnginesForVmCpuArchitecture(CPUArchitecture cpuArchitecture)
Returns the possibleVMExecutionEngineenum values for a given VM CPU architecture.

Parameters:
cpuArchitecture - The CPU architecture 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.