Sumário Itens Encontrados: 6791 Introduction 161.1 Modularity: the building blocks of VirtualBox 161.2 Two guises of the same âMain APIâ: the web service or COM/XPCOM 171.3 About web services in general 181.4 Running the web service 191.4.1 Command line options of vboxwebsrv 191.4.2 Authenticating at web service logon 201.4.3 Solaris host: starting the web service via SMF 202 Environment-specific notes 222.1 Using the object-oriented web service (OOWS) 222.1.1 The object-oriented web service for JAX-WS 222.1.2 The object-oriented web service for Python 242.1.3 The object-oriented web service for PHP 252.2 Using the raw web service with any language 252.2.1 Raw web service example for Java with Axis 252.2.2 Raw web service example for Perl 262.2.3 Programming considerations for the raw web service 272.3 Using COM/XPCOM directly 312.3.1 Python COM API 312.3.2 Common Python bindings layer 312.3.3 C++ COM API 322.3.4 Event queue processing 332.3.5 Visual Basic and Visual Basic Script (VBS) on Windows hosts 342.3.6 C binding to XPCOM API 343 Basic VirtualBox concepts; some examples 393.1 Obtaining basic machine information. Reading attributes 393.2 Changing machine settings. Sessions 393.3 Launching virtual machines 403.4 VirtualBox events 404 The VirtualBox shell 425 Classes (interfaces) 445.1 IAdditionsFacility 445.1.1 Attributes 445.2 IAdditionsStateChangedEvent (IEvent) 445.3 IAppliance 455.3.1 Attributes 465.3.2 createVFSExplorer 475.3.3 getWarnings 475.3.4 importMachines 475.3.5 interpret 475.3.6 read 475.3.7 write 485.4 IAudioAdapter 485.4.1 Attributes 485.5 IBIOSSettings 485.5.1 Attributes 495.6 IBandwidthControl 505.6.1 Attributes 505.6.2 createBandwidthGroup 505.6.3 deleteBandwidthGroup 505.6.4 getAllBandwidthGroups 505.6.5 getBandwidthGroup 505.7 IBandwidthGroup 505.7.1 Attributes 515.8 IBandwidthGroupChangedEvent (IEvent) 515.8.1 Attributes 515.9 ICPUChangedEvent (IEvent) 515.9.1 Attributes 515.10 ICPUExecutionCapChangedEvent (IEvent) 525.10.1 Attributes 525.11 ICanShowWindowEvent (IVetoEvent) 525.12 IConsole 525.12.1 Attributes 525.12.2 adoptSavedState 555.12.3 attachUSBDevice 555.12.4 createSharedFolder 555.12.5 deleteSnapshot 565.12.6 deleteSnapshotAndAllChildren 575.12.7 deleteSnapshotRange 575.12.8 detachUSBDevice 585.12.9 discardSavedState 585.12.10 findUSBDeviceByAddress 585.12.11 findUSBDeviceById 595.12.12 getDeviceActivity 595.12.13 getGuestEnteredACPIMode 595.12.14 getPowerButtonHandled 595.12.15 pause 595.12.16 powerButton 605.12.17 powerDown 605.12.18 powerUp 605.12.19 powerUpPaused 615.12.20 removeSharedFolder 615.12.21 reset 615.12.22 restoreSnapshot 615.12.23 resume 625.12.24 saveState 625.12.25 sleepButton 625.12.26 takeSnapshot 635.12.27 teleport 635.13 IDHCPServer 645.13.1 Attributes 645.13.2 setConfiguration 645.13.3 start 655.13.4 stop 655.14 IDisplay 655.14.1 completeVHWACommand 655.14.2 drawToScreen 665.14.3 getFramebuffer 665.14.4 getScreenResolution 675.14.5 invalidateAndUpdate 675.14.6 resizeCompleted 675.14.7 setFramebuffer 675.14.8 setSeamlessMode 685.14.9 setVideoModeHint 685.14.10 takeScreenShot 685.14.11 takeScreenShotPNGToArray 695.14.12 takeScreenShotToArray 695.15 IEvent 705.15.1 Attributes 715.15.2 setProcessed 715.15.3 waitProcessed 715.16 IEventListener 715.16.1 handleEvent 715.17 IEventSource 725.17.1 createAggregator 725.17.2 createListener 725.17.3 eventProcessed 725.17.4 fireEvent 725.17.5 getEvent 735.17.6 registerListener 735.17.7 unregisterListener 735.18 IEventSourceChangedEvent (IEvent) 745.18.1 Attributes 745.19 IExtPack (IExtPackBase) 745.19.1 queryObject 745.20 IExtPackBase 745.20.1 Attributes 755.20.2 queryLicense 765.21 IExtPackFile (IExtPackBase) 765.21.1 Attributes 765.21.2 install 775.22 IExtPackManager 775.22.1 Attributes 775.22.2 cleanup 775.22.3 find 775.22.4 isExtPackUsable 785.22.5 openExtPackFile 785.22.6 queryAllPlugInsForFrontend 785.22.7 uninstall 785.23 IExtPackPlugIn 785.23.1 Attributes 795.24 IExtraDataCanChangeEvent (IVetoEvent) 795.24.1 Attributes 795.25 IExtraDataChangedEvent (IEvent) 805.25.1 Attributes 805.26 IFramebuffer 805.26.1 Attributes 805.26.2 getVisibleRegion 825.26.3 lock 825.26.4 notifyUpdate 825.26.5 processVHWACommand 835.26.6 requestResize 835.26.7 setVisibleRegion 845.26.8 unlock 855.26.9 videoModeSupported 855.27 IFramebufferOverlay (IFramebuffer) 855.27.1 Attributes 865.27.2 move 865.28 IGuest 865.28.1 Attributes 875.28.2 copyFromGuest 875.28.3 copyToGuest 885.28.4 directoryClose 885.28.5 directoryCreate 895.28.6 directoryOpen 895.28.7 directoryRead 895.28.8 executeProcess 905.28.9 fileExists 905.28.10 fileQuerySize 915.28.11 getAdditionsStatus 915.28.12 getFacilityStatus 915.28.13 getProcessOutput 915.28.14 getProcessStatus 925.28.15 internalGetStatistics 925.28.16 setCredentials 935.28.17 setProcessInput 935.28.18 updateGuestAdditions 935.29 IGuestDirEntry 945.29.1 Attributes 945.30 IGuestKeyboardEvent (IEvent) 945.30.1 Attributes 945.31 IGuestMonitorChangedEvent (IEvent) 945.31.1 Attributes 955.32 IGuestMouseEvent (IReusableEvent) 955.32.1 Attributes 955.33 IGuestOSType 965.33.1 Attributes 965.34 IGuestPropertyChangedEvent (IMachineEvent) 995.34.1 Attributes 995.35 IHost 995.35.1 Attributes 995.35.2 createHostOnlyNetworkInterface 1015.35.3 createUSBDeviceFilter 1015.35.4 findHostDVDDrive 1025.35.5 findHostFloppyDrive 1025.35.6 findHostNetworkInterfaceById 1025.35.7 findHostNetworkInterfaceByName 1025.35.8 findHostNetworkInterfacesOfType 1025.35.9 findUSBDeviceByAddress 1035.35.10 findUSBDeviceById 1035.35.11 generateMACAddress 1035.35.12 getProcessorCPUIDLeaf 1035.35.13 getProcessorDescription 1045.35.14 getProcessorFeature 1045.35.15 getProcessorSpeed 1045.35.16 insertUSBDeviceFilter 1045.35.17 removeHostOnlyNetworkInterface 1055.35.18 removeUSBDeviceFilter 1055.36 IHostNetworkInterface 1055.36.1 Attributes 1055.36.2 dhcpRediscover 1075.36.3 enableDynamicIpConfig 1075.36.4 enableStaticIpConfig 1075.36.5 enableStaticIpConfigV6 1075.37 IHostPciDevicePlugEvent (IMachineEvent) 1075.37.1 Attributes 1075.38 IHostUSBDevice (IUSBDevice) 1085.38.1 Attributes 1085.39 IHostUSBDeviceFilter (IUSBDeviceFilter) 1085.39.1 Attributes 1095.40 IInternalMachineControl 1095.40.1 adoptSavedState 1095.40.2 autoCaptureUSBDevices 1095.40.3 beginPowerUp 1095.40.4 beginPoweringDown 1095.40.5 beginSavingState 1105.40.6 beginTakingSnapshot 1105.40.7 captureUSBDevice 1105.40.8 deleteSnapshot 1115.40.9 detachAllUSBDevices 1115.40.10 detachUSBDevice 1115.40.11 ejectMedium 1125.40.12 endPowerUp 1125.40.13 endPoweringDown 1125.40.14 endSavingState 1125.40.15 endTakingSnapshot 1135.40.16 finishOnlineMergeMedium 1135.40.17 getIPCId 1135.40.18 lockMedia 1135.40.19 onSessionEnd 1135.40.20 pullGuestProperties 1145.40.21 pushGuestProperty 1145.40.22 restoreSnapshot 1145.40.23 runUSBDeviceFilters 1155.40.24 setRemoveSavedStateFile 1155.40.25 unlockMedia 1155.40.26 updateState 1155.41 IInternalSessionControl 1155.41.1 accessGuestProperty 1165.41.2 assignMachine 1165.41.3 assignRemoteMachine 1165.41.4 enumerateGuestProperties 1175.41.5 getPID 1175.41.6 getRemoteConsole 1175.41.7 onBandwidthGroupChange 1175.41.8 onCPUChange 1185.41.9 onCPUExecutionCapChange 1185.41.10 onMediumChange 1185.41.11 onNetworkAdapterChange 1185.41.12 onParallelPortChange 1195.41.13 onSerialPortChange 1195.41.14 onSharedFolderChange 1195.41.15 onShowWindow 1195.41.16 onStorageControllerChange 1205.41.17 onStorageDeviceChange 1205.41.18 onUSBControllerChange 1205.41.19 onUSBDeviceAttach 1205.41.20 onUSBDeviceDetach 1215.41.21 onVRDEServerChange 1215.41.22 onlineMergeMedium 1215.41.23 uninitialize 1225.41.24 updateMachineState 1225.42 IKeyboard 1225.42.1 Attributes 1235.42.2 putCAD 1235.42.3 putScancode 1235.42.4 putScancodes 1235.43 IKeyboardLedsChangedEvent (IEvent) 1235.43.1 Attributes 1235.44 IMachine 1245.44.1 Attributes 1245.44.2 addStorageController 1345.44.3 attachDevice 1345.44.4 attachHostPciDevice 1355.44.5 canShowConsoleWindow 1365.44.6 cloneTo 1365.44.7 createSharedFolder 1365.44.8 delete 1375.44.9 detachDevice 1375.44.10 detachHostPciDevice 1385.44.11 discardSettings 1385.44.12 enumerateGuestProperties 1395.44.13 export 1395.44.14 findSnapshot 1395.44.15 getBootOrder 1405.44.16 getCPUIDLeaf 1405.44.17 getCPUProperty 1415.44.18 getCPUStatus 1415.44.19 getExtraData 1415.44.20 getExtraDataKeys 1415.44.21 getGuestProperty 1415.44.22 getGuestPropertyTimestamp 1425.44.23 getGuestPropertyValue 1425.44.24 getHWVirtExProperty 1425.44.25 getMedium 1425.44.26 getMediumAttachment 1435.44.27 getMediumAttachmentsOfController 1435.44.28 getNetworkAdapter 1435.44.29 getParallelPort 1445.44.30 getSerialPort 1445.44.31 getStorageControllerByInstance 1445.44.32 getStorageControllerByName 1445.44.33 hotPlugCPU 1455.44.34 hotUnplugCPU 1455.44.35 launchVMProcess 1455.44.36 lockMachine 1465.44.37 mountMedium 1475.44.38 nonRotationalDevice 1485.44.39 passthroughDevice 1495.44.40 queryLogFilename 1495.44.41 querySavedGuestSize 1495.44.42 querySavedScreenshotPNGSize 1505.44.43 querySavedThumbnailSize 1505.44.44 readLog 1505.44.45 readSavedScreenshotPNGToArray 1505.44.46 readSavedThumbnailPNGToArray 1515.44.47 readSavedThumbnailToArray 1515.44.48 removeAllCPUIDLeaves 1515.44.49 removeCPUIDLeaf 1515.44.50 removeSharedFolder 1525.44.51 removeStorageController 1525.44.52 saveSettings 1525.44.53 setBandwidthGroupForDevice 1535.44.54 setBootOrder 1535.44.55 setCPUIDLeaf 1535.44.56 setCPUProperty 1545.44.57 setExtraData 1545.44.58 setGuestProperty 1555.44.59 setGuestPropertyValue 1555.44.60 setHWVirtExProperty 1565.44.61 setStorageControllerBootable 1565.44.62 showConsoleWindow 1565.44.63 temporaryEjectDevice 1575.44.64 unregister 1575.45 IMachineDataChangedEvent (IMachineEvent) 1585.45.1 Attributes 1585.46 IMachineDebugger 1595.46.1 Attributes 1595.46.2 detectOS 1615.46.3 dumpGuestCore 1615.46.4 dumpGuestStack 1615.46.5 dumpHostProcessCore 1615.46.6 dumpStats 1615.46.7 getRegister 1625.46.8 getRegisters 1625.46.9 getStats 1625.46.10 info 1625.46.11 injectNMI 1635.46.12 modifyLogDestinations 1635.46.13 modifyLogFlags 1635.46.14 modifyLogGroups 1635.46.15 readPhysicalMemory 1635.46.16 readVirtualMemory 1635.46.17 resetStats 1645.46.18 setRegister 1645.46.19 setRegisters 1645.46.20 writePhysicalMemory 1645.46.21 writeVirtualMemory 1655.47 IMachineEvent (IEvent) 1655.47.1 Attributes 1655.48 IMachineRegisteredEvent (IMachineEvent) 1655.48.1 Attributes 1655.49 IMachineStateChangedEvent (IMachineEvent) 1665.49.1 Attributes 1665.50 IManagedObjectRef 1665.50.1 getInterfaceName 1665.50.2 release 1665.51 IMedium 1675.51.1 Attributes 1685.51.2 cloneTo 1735.51.3 close 1745.51.4 compact 1745.51.5 createBaseStorage 1745.51.6 createDiffStorage 1755.51.7 deleteStorage 1755.51.8 getProperties 1765.51.9 getProperty 1765.51.10 getSnapshotIds 1775.51.11 lockRead 1775.51.12 lockWrite 1775.51.13 mergeTo 1785.51.14 refreshState 1795.51.15 reset 1795.51.16 resize 1805.51.17 setIDs 1805.51.18 setProperties 1805.51.19 setProperty 1815.51.20 unlockRead 1815.51.21 unlockWrite 1825.52 IMediumAttachment 1825.52.1 Attributes 1845.53 IMediumChangedEvent (IEvent) 1855.53.1 Attributes 1855.54 IMediumFormat 1865.54.1 Attributes 1865.54.2 describeFileExtensions 1865.54.3 describeProperties 1875.55 IMediumRegisteredEvent (IEvent) 1875.55.1 Attributes 1875.56 IMouse 1885.56.1 Attributes 1885.56.2 putMouseEvent 1895.56.3 putMouseEventAbsolute 1895.57 IMouseCapabilityChangedEvent (IEvent) 1905.57.1 Attributes 1905.58 IMousePointerShapeChangedEvent (IEvent) 1905.58.1 Attributes 1905.59 INATEngine 1915.59.1 Attributes 1925.59.2 addRedirect 1935.59.3 getNetworkSettings 1935.59.4 Redirect 1945.59.5 setNetworkSettings 1945.60 INATRedirectEvent (IMachineEvent) 1945.60.1 Attributes 1945.61 INetworkAdapter 1955.61.1 Attributes 1955.61.2 getProperties 1975.61.3 getProperty 1985.61.4 setProperty 1985.62 INetworkAdapterChangedEvent (IEvent) 1985.62.1 Attributes 1995.63 IParallelPort 1995.63.1 Attributes 1995.64 IParallelPortChangedEvent (IEvent) 2005.64.1 Attributes 2005.65 IPciAddress 2005.65.1 Attributes 2005.65.2 asLong 2005.65.3 fromLong 2015.66 IPciDeviceAttachment 2015.66.1 Attributes 2015.67 IPerformanceCollector 2015.67.1 Attributes 2035.67.2 disableMetrics 2035.67.3 enableMetrics 2035.67.4 getMetrics 2045.67.5 queryMetricsData 2045.67.6 setupMetrics 2055.68 IPerformanceMetric 2055.68.1 Attributes 2055.69 IProgress 2065.69.1 Attributes 2075.69.2 cancel 2095.69.3 setCurrentOperationProgress 2095.69.4 setNextOperation 2095.69.5 waitForAsyncProgressCompletion 2095.69.6 waitForCompletion 2105.69.7 waitForOperationCompletion 2105.70 IReusableEvent (IEvent) 2105.70.1 Attributes 2105.70.2 reuse 2105.71 IRuntimeErrorEvent (IEvent) 2115.71.1 Attributes 2115.72 ISerialPort 2125.72.1 Attributes 2125.73 ISerialPortChangedEvent (IEvent) 2135.73.1 Attributes 2135.74 ISession 2135.74.1 Attributes 2145.74.2 unlockMachine 2145.75 ISessionStateChangedEvent (IMachineEvent) 2155.75.1 Attributes 2155.76 ISharedFolder 2155.76.1 Attributes 2165.77 ISharedFolderChangedEvent (IEvent) 2175.77.1 Attributes 2175.78 IShowWindowEvent (IEvent) 2175.78.1 Attributes 2175.79 ISnapshot 2185.79.1 Attributes 2185.79.2 getChildrenCount 2205.80 ISnapshotChangedEvent (ISnapshotEvent) 2205.81 ISnapshotDeletedEvent (ISnapshotEvent) 2205.82 ISnapshotEvent (IMachineEvent) 2205.82.1 Attributes 2205.83 ISnapshotTakenEvent (ISnapshotEvent) 2215.84 IStateChangedEvent (IEvent) 2215.84.1 Attributes 2215.85 IStorageController 2215.85.1 Attributes 2215.85.2 getIDEEmulationPort 2235.85.3 setIDEEmulationPort 2235.86 IStorageControllerChangedEvent (IEvent) 2235.87 IStorageDeviceChangedEvent (IEvent) 2235.87.1 Attributes 2245.88 ISystemProperties 2245.88.1 Attributes 2245.88.2 getDefaultIoCacheSettingForStorageController 2285.88.3 getDeviceTypesForStorageBus 2285.88.4 getMaxDevicesPerPortForStorageBus 2285.88.5 getMaxInstancesOfStorageBus 2285.88.6 getMaxNetworkAdapters 2285.88.7 getMaxNetworkAdaptersOfType 2295.88.8 getMaxPortCountForStorageBus 2295.88.9 getMinPortCountForStorageBus 2295.89 IUSBController 2295.89.1 Attributes 2295.89.2 createDeviceFilter 2305.89.3 insertDeviceFilter 2305.89.4 removeDeviceFilter 2315.90 IUSBControllerChangedEvent (IEvent) 2315.91 IUSBDevice 2315.91.1 Attributes 2315.92 IUSBDeviceFilter 2335.92.1 Attributes 2335.93 IUSBDeviceStateChangedEvent (IEvent) 2355.93.1 Attributes 2355.94 IVBoxSVCAvailabilityChangedEvent (IEvent) 2365.94.1 Attributes 2365.95 IVFSExplorer 2365.95.1 Attributes 2365.95.2 cd 2365.95.3 cdUp 2365.95.4 entryList 2375.95.5 exists 2375.95.6 remove 2375.95.7 update 2375.96 IVRDEServer 2375.96.1 Attributes 2375.96.2 getVRDEProperty 2385.96.3 setVRDEProperty 2385.97 IVRDEServerChangedEvent (IEvent) 2395.98 IVRDEServerInfo 2395.98.1 Attributes 2395.99 IVRDEServerInfoChangedEvent (IEvent) 2415.100 IVetoEvent (IEvent) 2415.100.1 addVeto 2415.100.2 getVetos 2415.100.3 isVetoed 2415.101 IVirtualBox 2415.101.1 Attributes 2425.101.2 checkFirmwarePresent 2445.101.3 composeMachineFilename 2455.101.4 createAppliance 2455.101.5 createDHCPServer 2455.101.6 createHardDisk 2455.101.7 createMachine 2465.101.8 createSharedFolder 2475.101.9 findDHCPServerByNetworkName 2485.101.10findMachine 2485.101.11findMedium 2485.101.12getExtraData 2495.101.13getExtraDataKeys 2495.101.14getGuestOSType 2495.101.15openMachine 2495.101.16openMedium 2505.101.17registerMachine 2515.101.18removeDHCPServer 2515.101.19removeSharedFolder 2515.101.20setExtraData 2525.102 IVirtualBoxClient 2525.102.1 Attributes 2525.103 IVirtualBoxErrorInfo 2535.103.1 Attributes 2535.104 IVirtualSystemDescription 2545.104.1 Attributes 2545.104.2 addDescription 2555.104.3 getDescription 2555.104.4 getDescriptionByType 2575.104.5 getValuesByType 2575.104.6 setFinalValues 2585.105 IWebsessionManager 2585.105.1 getSessionObject 2585.105.2 logoff 2585.105.3 logon 2596 Enumerations (enums) 2606.1 AccessMode 2606.2 AdditionsFacilityClass 2606.3 AdditionsFacilityStatus 2606.4 AdditionsFacilityType 2616.5 AdditionsRunLevelType 2616.6 AdditionsUpdateFlag 2616.7 AudioControllerType 2616.8 AudioDriverType 2626.9 AuthType 2626.10 BIOSBootMenuMode 2626.11 BandwidthGroupType 2626.12 CPUPropertyType 2636.13 ChipsetType 2636.14 CleanupMode 2636.15 ClipboardMode 2636.16 CloneMode 2646.17 CloneOptions 2646.18 CopyFileFlag 2646.19 DataFlags 2646.20 DataType 2646.21 DeviceActivity 2656.22 DeviceType 2656.23 DirectoryCreateFlag 2656.24 DirectoryOpenFlag 2656.25 ExecuteProcessFlag 2656.26 ExecuteProcessStatus 2666.27 FaultToleranceState 2666.28 FirmwareType 2666.29 FramebufferPixelFormat 2666.30 GuestDirEntryType 2676.31 GuestMonitorChangedEventType 2676.32 HWVirtExPropertyType 2676.33 HostNetworkInterfaceMediumType 2676.34 HostNetworkInterfaceStatus 2686.35 HostNetworkInterfaceType 2686.36 ImportOptions 2686.37 KeyboardHidType 2686.38 LockType 2686.39 MachineState 2696.40 MediumFormatCapabilities 2716.41 MediumState 2726.42 MediumType 2726.43 MediumVariant 2736.44 MouseButtonState 2736.45 NATAliasMode 2736.46 NATProtocol 2746.47 NetworkAdapterPromiscModePolicy 2746.48 NetworkAdapterType 274s6.49 NetworkAttachmentType 2746.50 PointingHidType 2756.51 PortMode 2756.52 ProcessInputFlag 2756.53 ProcessOutputFlag 2756.54 ProcessorFeature 2756.55 Scope 2766.56 SessionState 2766.57 SessionType 2766.58 SettingsVersion 2766.59 StorageBus 2776.60 StorageControllerType 2776.61 USBDeviceFilterAction 2786.62 USBDeviceState 2786.63 VBoxEventType 2786.64 VFSFileType 2806.65 VFSType 2816.66 VirtualSystemDescriptionType 2816.67 VirtualSystemDescriptionValueType 2827 Host-Guest Communication Manager 2837.1 Virtual hardware implementation 2837.2 Protocol specification 2837.2.1 Request header 2837.2.2 Connect 2847.2.3 Disconnect 2857.2.4 Call32 and Call64 2857.2.5 Cancel 2867.3 Guest software interface 2867.3.1 The guest driver interface 2867.3.2 Guest application interface 2887.4 HGCM Service Implementation 2898 RDP Web Control 2908.1 RDPWeb features 2908.2 RDPWeb reference 2908.2.1 RDPWeb functions 2908.2.2 Embedding RDPWeb in an HTML page 2918.3 RDPWeb change log 2918.3.1 Version 1.2.28 2918.3.2 Version 1.1.26 2918.3.3 Version 1.0.24 2919 VirtualBox external authentication modules 29210 Using Java API 29410.1 Introduction 29410.2 Requirements 29410.3 Example 29511 License information 29612 Main API change log 29712.1 Incompatible API changes with version 4.1 29712.2 Incompatible API changes with version 4.0 29812.3 Incompatible API changes with version 3.2 30012.4 Incompatible API changes with version 3.1 30112.5 Incompatible API changes with version 3.0 30212.6 Incompatible API changes with version 2.2 30312.7 Incompatible API changes with version 2.1 303