00001
00002
00003
00004
00005
00006
00007
00008
00009
00010
00011
00012
00013
00014
00015
00016
00017
00137 const HRESULT VBOX_E_OBJECT_NOT_FOUND = 0x80BB0001;
00145 const HRESULT VBOX_E_INVALID_VM_STATE = 0x80BB0002;
00153 const HRESULT VBOX_E_VM_ERROR = 0x80BB0003;
00161 const HRESULT VBOX_E_FILE_ERROR = 0x80BB0004;
00169 const HRESULT VBOX_E_IPRT_ERROR = 0x80BB0005;
00177 const HRESULT VBOX_E_PDM_ERROR = 0x80BB0006;
00185 const HRESULT VBOX_E_INVALID_OBJECT_STATE = 0x80BB0007;
00193 const HRESULT VBOX_E_HOST_ERROR = 0x80BB0008;
00201 const HRESULT VBOX_E_NOT_SUPPORTED = 0x80BB0009;
00209 const HRESULT VBOX_E_XML_ERROR = 0x80BB000A;
00217 const HRESULT VBOX_E_INVALID_SESSION_STATE = 0x80BB000B;
00225 const HRESULT VBOX_E_OBJECT_IN_USE = 0x80BB000C;
00235 enum SettingsVersion
00236 {
00241 SettingsVersion_Null = 0,
00246 SettingsVersion_v1_0 = 1,
00251 SettingsVersion_v1_1 = 2,
00256 SettingsVersion_v1_2 = 3,
00261 SettingsVersion_v1_3pre = 4,
00266 SettingsVersion_v1_3 = 5,
00271 SettingsVersion_v1_4 = 6,
00276 SettingsVersion_v1_5 = 7,
00281 SettingsVersion_v1_6 = 8,
00286 SettingsVersion_v1_7 = 9,
00291 SettingsVersion_v1_8 = 10,
00296 SettingsVersion_v1_9 = 11,
00301 SettingsVersion_v1_10 = 12,
00306 SettingsVersion_v1_11 = 13,
00311 SettingsVersion_v1_12 = 14,
00316 SettingsVersion_v1_13 = 15,
00321 SettingsVersion_v1_14 = 16,
00326 SettingsVersion_Future = 99999,
00327 };
00328
00336 enum AccessMode
00337 {
00338 AccessMode_ReadOnly = 1,
00339 AccessMode_ReadWrite = 2,
00340 };
00341
00459 enum MachineState
00460 {
00465 MachineState_Null = 0,
00473 MachineState_PoweredOff = 1,
00482 MachineState_Saved = 2,
00491 MachineState_Teleported = 3,
00500 MachineState_Aborted = 4,
00507 MachineState_Running = 5,
00514 MachineState_Paused = 6,
00522 MachineState_Stuck = 7,
00532 MachineState_Teleporting = 8,
00543 MachineState_LiveSnapshotting = 9,
00551 MachineState_Starting = 10,
00559 MachineState_Stopping = 11,
00567 MachineState_Saving = 12,
00575 MachineState_Restoring = 13,
00584 MachineState_TeleportingPausedVM = 14,
00591 MachineState_TeleportingIn = 15,
00598 MachineState_FaultTolerantSyncing = 16,
00606 MachineState_DeletingSnapshotOnline = 17,
00614 MachineState_DeletingSnapshotPaused = 18,
00621 MachineState_RestoringSnapshot = 19,
00630 MachineState_DeletingSnapshot = 20,
00637 MachineState_SettingUp = 21,
00644 MachineState_FirstOnline = 5,
00651 MachineState_LastOnline = 18,
00658 MachineState_FirstTransient = 8,
00665 MachineState_LastTransient = 21,
00666 };
00667
00677 enum SessionState
00678 {
00683 SessionState_Null = 0,
00694 SessionState_Unlocked = 1,
00708 SessionState_Locked = 2,
00718 SessionState_Spawning = 3,
00725 SessionState_Unlocking = 4,
00726 };
00727
00736 enum CPUPropertyType
00737 {
00742 CPUPropertyType_Null = 0,
00751 CPUPropertyType_PAE = 1,
00759 CPUPropertyType_Synthetic = 2,
00767 CPUPropertyType_LongMode = 3,
00775 CPUPropertyType_TripleFaultReset = 4,
00776 };
00777
00787 enum HWVirtExPropertyType
00788 {
00793 HWVirtExPropertyType_Null = 0,
00801 HWVirtExPropertyType_Enabled = 1,
00808 HWVirtExPropertyType_VPID = 2,
00815 HWVirtExPropertyType_NestedPaging = 3,
00822 HWVirtExPropertyType_UnrestrictedExecution = 4,
00829 HWVirtExPropertyType_LargePages = 5,
00837 HWVirtExPropertyType_Force = 6,
00838 };
00839
00847 enum FaultToleranceState
00848 {
00853 FaultToleranceState_Inactive = 1,
00858 FaultToleranceState_Master = 2,
00863 FaultToleranceState_Standby = 3,
00864 };
00865
00873 enum LockType
00874 {
00883 LockType_Write = 2,
00890 LockType_Shared = 1,
00896 LockType_VM = 3,
00897 };
00898
00907 enum SessionType
00908 {
00913 SessionType_Null = 0,
00921 SessionType_WriteLock = 1,
00928 SessionType_Remote = 2,
00935 SessionType_Shared = 3,
00936 };
00937
00945 enum DeviceType
00946 {
00954 DeviceType_Null = 0,
00959 DeviceType_Floppy = 1,
00964 DeviceType_DVD = 2,
00969 DeviceType_HardDisk = 3,
00974 DeviceType_Network = 4,
00979 DeviceType_USB = 5,
00984 DeviceType_SharedFolder = 6,
00985 };
00986
00994 enum DeviceActivity
00995 {
00996 DeviceActivity_Null = 0,
00997 DeviceActivity_Idle = 1,
00998 DeviceActivity_Reading = 2,
00999 DeviceActivity_Writing = 3,
01000 };
01001
01009 enum ClipboardMode
01010 {
01011 ClipboardMode_Disabled = 0,
01012 ClipboardMode_HostToGuest = 1,
01013 ClipboardMode_GuestToHost = 2,
01014 ClipboardMode_Bidirectional = 3,
01015 };
01016
01024 enum DragAndDropMode
01025 {
01026 DragAndDropMode_Disabled = 0,
01027 DragAndDropMode_HostToGuest = 1,
01028 DragAndDropMode_GuestToHost = 2,
01029 DragAndDropMode_Bidirectional = 3,
01030 };
01031
01042 enum Scope
01043 {
01044 Scope_Global = 0,
01045 Scope_Machine = 1,
01046 Scope_Session = 2,
01047 };
01048
01056 enum BIOSBootMenuMode
01057 {
01058 BIOSBootMenuMode_Disabled = 0,
01059 BIOSBootMenuMode_MenuOnly = 1,
01060 BIOSBootMenuMode_MessageAndMenu = 2,
01061 };
01062
01070 enum ProcessorFeature
01071 {
01072 ProcessorFeature_HWVirtEx = 0,
01073 ProcessorFeature_PAE = 1,
01074 ProcessorFeature_LongMode = 2,
01075 ProcessorFeature_NestedPaging = 3,
01076 };
01077
01085 enum FirmwareType
01086 {
01091 FirmwareType_BIOS = 1,
01096 FirmwareType_EFI = 2,
01101 FirmwareType_EFI32 = 3,
01106 FirmwareType_EFI64 = 4,
01111 FirmwareType_EFIDUAL = 5,
01112 };
01113
01121 enum PointingHIDType
01122 {
01127 PointingHIDType_None = 1,
01132 PointingHIDType_PS2Mouse = 2,
01137 PointingHIDType_USBMouse = 3,
01145 PointingHIDType_USBTablet = 4,
01153 PointingHIDType_ComboMouse = 5,
01160 PointingHIDType_USBMultiTouch = 6,
01161 };
01162
01170 enum KeyboardHIDType
01171 {
01176 KeyboardHIDType_None = 1,
01181 KeyboardHIDType_PS2Keyboard = 2,
01186 KeyboardHIDType_USBKeyboard = 3,
01192 KeyboardHIDType_ComboKeyboard = 4,
01193 };
01194
01195 enum DhcpOpt
01196 {
01197 DhcpOpt_SubnetMask = 1,
01198 DhcpOpt_TimeOffset = 2,
01199 DhcpOpt_Router = 3,
01200 DhcpOpt_TimeServer = 4,
01201 DhcpOpt_NameServer = 5,
01202 DhcpOpt_DomainNameServer = 6,
01203 DhcpOpt_LogServer = 7,
01204 DhcpOpt_Cookie = 8,
01205 DhcpOpt_LPRServer = 9,
01206 DhcpOpt_ImpressServer = 10,
01207 DhcpOpt_ResourseLocationServer = 11,
01208 DhcpOpt_HostName = 12,
01209 DhcpOpt_BootFileSize = 13,
01210 DhcpOpt_MeritDumpFile = 14,
01211 DhcpOpt_DomainName = 15,
01212 DhcpOpt_SwapServer = 16,
01213 DhcpOpt_RootPath = 17,
01214 DhcpOpt_ExtensionPath = 18,
01215 DhcpOpt_IPForwardingEnableDisable = 19,
01216 DhcpOpt_NonLocalSourceRoutingEnableDisable = 20,
01217 DhcpOpt_PolicyFilter = 21,
01218 DhcpOpt_MaximumDatagramReassemblySize = 22,
01219 DhcpOpt_DefaultIPTime2Live = 23,
01220 DhcpOpt_PathMTUAgingTimeout = 24,
01221 DhcpOpt_IPLayerParametersPerInterface = 25,
01222 DhcpOpt_InterfaceMTU = 26,
01223 DhcpOpt_AllSubnetsAreLocal = 27,
01224 DhcpOpt_BroadcastAddress = 28,
01225 DhcpOpt_PerformMaskDiscovery = 29,
01226 DhcpOpt_MaskSupplier = 30,
01227 DhcpOpt_PerformRouteDiscovery = 31,
01228 DhcpOpt_RouterSolicitationAddress = 32,
01229 DhcpOpt_StaticRoute = 33,
01230 DhcpOpt_TrailerEncapsulation = 34,
01231 DhcpOpt_ARPCacheTimeout = 35,
01232 DhcpOpt_EthernetEncapsulation = 36,
01233 DhcpOpt_TCPDefaultTTL = 37,
01234 DhcpOpt_TCPKeepAliveInterval = 38,
01235 DhcpOpt_TCPKeepAliveGarbage = 39,
01236 DhcpOpt_NetworkInformationServiceDomain = 40,
01237 DhcpOpt_NetworkInformationServiceServers = 41,
01238 DhcpOpt_NetworkTimeProtocolServers = 42,
01239 DhcpOpt_VendorSpecificInformation = 43,
01240 DhcpOpt_Option_44 = 44,
01241 DhcpOpt_Option_45 = 45,
01242 DhcpOpt_Option_46 = 46,
01243 DhcpOpt_Option_47 = 47,
01244 DhcpOpt_Option_48 = 48,
01245 DhcpOpt_Option_49 = 49,
01246 DhcpOpt_IPAddressLeaseTime = 51,
01247 DhcpOpt_Option_64 = 64,
01248 DhcpOpt_Option_65 = 65,
01249 DhcpOpt_TFTPServerName = 66,
01250 DhcpOpt_BootfileName = 67,
01251 DhcpOpt_Option_68 = 68,
01252 DhcpOpt_Option_69 = 69,
01253 DhcpOpt_Option_70 = 70,
01254 DhcpOpt_Option_71 = 71,
01255 DhcpOpt_Option_72 = 72,
01256 DhcpOpt_Option_73 = 73,
01257 DhcpOpt_Option_74 = 74,
01258 DhcpOpt_Option_75 = 75,
01259 DhcpOpt_Option_119 = 119,
01260 };
01261
01269 enum VFSType
01270 {
01271 VFSType_File = 1,
01272 VFSType_Cloud = 2,
01273 VFSType_S3 = 3,
01274 VFSType_WebDav = 4,
01275 };
01276
01284 enum VFSFileType
01285 {
01286 VFSFileType_Unknown = 1,
01287 VFSFileType_Fifo = 2,
01288 VFSFileType_DevChar = 3,
01289 VFSFileType_Directory = 4,
01290 VFSFileType_DevBlock = 5,
01291 VFSFileType_File = 6,
01292 VFSFileType_SymLink = 7,
01293 VFSFileType_Socket = 8,
01294 VFSFileType_WhiteOut = 9,
01295 };
01296
01304 enum ImportOptions
01305 {
01310 ImportOptions_KeepAllMACs = 1,
01315 ImportOptions_KeepNATMACs = 2,
01316 };
01317
01325 enum ExportOptions
01326 {
01332 ExportOptions_CreateManifest = 1,
01338 ExportOptions_ExportDVDImages = 2,
01346 ExportOptions_StripAllMACs = 3,
01354 ExportOptions_StripAllNonNATMACs = 4,
01355 };
01356
01363 enum VirtualSystemDescriptionType
01364 {
01365 VirtualSystemDescriptionType_Ignore = 1,
01366 VirtualSystemDescriptionType_OS = 2,
01367 VirtualSystemDescriptionType_Name = 3,
01368 VirtualSystemDescriptionType_Product = 4,
01369 VirtualSystemDescriptionType_Vendor = 5,
01370 VirtualSystemDescriptionType_Version = 6,
01371 VirtualSystemDescriptionType_ProductUrl = 7,
01372 VirtualSystemDescriptionType_VendorUrl = 8,
01373 VirtualSystemDescriptionType_Description = 9,
01374 VirtualSystemDescriptionType_License = 10,
01375 VirtualSystemDescriptionType_Miscellaneous = 11,
01376 VirtualSystemDescriptionType_CPU = 12,
01377 VirtualSystemDescriptionType_Memory = 13,
01378 VirtualSystemDescriptionType_HardDiskControllerIDE = 14,
01379 VirtualSystemDescriptionType_HardDiskControllerSATA = 15,
01380 VirtualSystemDescriptionType_HardDiskControllerSCSI = 16,
01381 VirtualSystemDescriptionType_HardDiskControllerSAS = 17,
01382 VirtualSystemDescriptionType_HardDiskImage = 18,
01383 VirtualSystemDescriptionType_Floppy = 19,
01384 VirtualSystemDescriptionType_CDROM = 20,
01385 VirtualSystemDescriptionType_NetworkAdapter = 21,
01386 VirtualSystemDescriptionType_USBController = 22,
01387 VirtualSystemDescriptionType_SoundCard = 23,
01392 VirtualSystemDescriptionType_SettingsFile = 24,
01393 };
01394
01401 enum VirtualSystemDescriptionValueType
01402 {
01403 VirtualSystemDescriptionValueType_Reference = 1,
01404 VirtualSystemDescriptionValueType_Original = 2,
01405 VirtualSystemDescriptionValueType_Auto = 3,
01406 VirtualSystemDescriptionValueType_ExtraConfig = 4,
01407 };
01408
01415 enum GraphicsControllerType
01416 {
01421 GraphicsControllerType_Null = 0,
01426 GraphicsControllerType_VBoxVGA = 1,
01431 GraphicsControllerType_VMSVGA = 2,
01432 };
01433
01440 enum CleanupMode
01441 {
01446 CleanupMode_UnregisterOnly = 1,
01451 CleanupMode_DetachAllReturnNone = 2,
01456 CleanupMode_DetachAllReturnHardDisksOnly = 3,
01461 CleanupMode_Full = 4,
01462 };
01463
01471 enum CloneMode
01472 {
01477 CloneMode_MachineState = 1,
01482 CloneMode_MachineAndChildStates = 2,
01487 CloneMode_AllStates = 3,
01488 };
01489
01497 enum CloneOptions
01498 {
01503 CloneOptions_Link = 1,
01508 CloneOptions_KeepAllMACs = 2,
01513 CloneOptions_KeepNATMACs = 3,
01518 CloneOptions_KeepDiskNames = 4,
01519 };
01520
01528 enum AutostopType
01529 {
01534 AutostopType_Disabled = 1,
01539 AutostopType_SaveState = 2,
01544 AutostopType_PowerOff = 3,
01549 AutostopType_AcpiShutdown = 4,
01550 };
01551
01562 enum HostNetworkInterfaceMediumType
01563 {
01570 HostNetworkInterfaceMediumType_Unknown = 0,
01577 HostNetworkInterfaceMediumType_Ethernet = 1,
01584 HostNetworkInterfaceMediumType_PPP = 2,
01591 HostNetworkInterfaceMediumType_SLIP = 3,
01592 };
01593
01603 enum HostNetworkInterfaceStatus
01604 {
01611 HostNetworkInterfaceStatus_Unknown = 0,
01618 HostNetworkInterfaceStatus_Up = 1,
01625 HostNetworkInterfaceStatus_Down = 2,
01626 };
01627
01635 enum HostNetworkInterfaceType
01636 {
01637 HostNetworkInterfaceType_Bridged = 1,
01638 HostNetworkInterfaceType_HostOnly = 2,
01639 };
01640
01648 enum AdditionsFacilityType
01649 {
01654 AdditionsFacilityType_None = 0,
01659 AdditionsFacilityType_VBoxGuestDriver = 20,
01664 AdditionsFacilityType_AutoLogon = 90,
01669 AdditionsFacilityType_VBoxService = 100,
01674 AdditionsFacilityType_VBoxTrayClient = 101,
01679 AdditionsFacilityType_Seamless = 1000,
01687 AdditionsFacilityType_Graphics = 1100,
01692 AdditionsFacilityType_All = 2147483646,
01693 };
01694
01702 enum AdditionsFacilityClass
01703 {
01708 AdditionsFacilityClass_None = 0,
01713 AdditionsFacilityClass_Driver = 10,
01718 AdditionsFacilityClass_Service = 30,
01723 AdditionsFacilityClass_Program = 50,
01728 AdditionsFacilityClass_Feature = 100,
01733 AdditionsFacilityClass_ThirdParty = 999,
01738 AdditionsFacilityClass_All = 2147483646,
01739 };
01740
01748 enum AdditionsFacilityStatus
01749 {
01754 AdditionsFacilityStatus_Inactive = 0,
01759 AdditionsFacilityStatus_Paused = 1,
01764 AdditionsFacilityStatus_PreInit = 20,
01769 AdditionsFacilityStatus_Init = 30,
01774 AdditionsFacilityStatus_Active = 50,
01779 AdditionsFacilityStatus_Terminating = 100,
01784 AdditionsFacilityStatus_Terminated = 101,
01789 AdditionsFacilityStatus_Failed = 800,
01794 AdditionsFacilityStatus_Unknown = 999,
01795 };
01796
01804 enum AdditionsRunLevelType
01805 {
01810 AdditionsRunLevelType_None = 0,
01815 AdditionsRunLevelType_System = 1,
01820 AdditionsRunLevelType_Userland = 2,
01825 AdditionsRunLevelType_Desktop = 3,
01826 };
01827
01835 enum AdditionsUpdateFlag
01836 {
01841 AdditionsUpdateFlag_None = 0,
01849 AdditionsUpdateFlag_WaitForUpdateStartOnly = 1,
01850 };
01851
01860 enum GuestSessionStatus
01861 {
01866 GuestSessionStatus_Undefined = 0,
01871 GuestSessionStatus_Starting = 10,
01876 GuestSessionStatus_Started = 100,
01881 GuestSessionStatus_Terminating = 480,
01886 GuestSessionStatus_Terminated = 500,
01891 GuestSessionStatus_TimedOutKilled = 512,
01896 GuestSessionStatus_TimedOutAbnormally = 513,
01901 GuestSessionStatus_Down = 600,
01906 GuestSessionStatus_Error = 800,
01907 };
01908
01916 enum GuestSessionWaitForFlag
01917 {
01922 GuestSessionWaitForFlag_None = 0,
01927 GuestSessionWaitForFlag_Start = 1,
01932 GuestSessionWaitForFlag_Terminate = 2,
01937 GuestSessionWaitForFlag_Status = 4,
01938 };
01939
01953 enum GuestSessionWaitResult
01954 {
01959 GuestSessionWaitResult_None = 0,
01964 GuestSessionWaitResult_Start = 1,
01969 GuestSessionWaitResult_Terminate = 2,
01977 GuestSessionWaitResult_Status = 3,
01982 GuestSessionWaitResult_Error = 4,
01991 GuestSessionWaitResult_Timeout = 5,
01999 GuestSessionWaitResult_WaitFlagNotSupported = 6,
02000 };
02001
02009 enum GuestUserState
02010 {
02015 GuestUserState_Unknown = 0,
02024 GuestUserState_LoggedIn = 1,
02033 GuestUserState_LoggedOut = 2,
02043 GuestUserState_Locked = 3,
02051 GuestUserState_Unlocked = 4,
02059 GuestUserState_Disabled = 5,
02081 GuestUserState_Idle = 6,
02087 GuestUserState_InUse = 7,
02095 GuestUserState_Created = 8,
02103 GuestUserState_Deleted = 9,
02111 GuestUserState_SessionChanged = 10,
02121 GuestUserState_CredentialsChanged = 11,
02130 GuestUserState_RoleChanged = 12,
02139 GuestUserState_GroupAdded = 13,
02148 GuestUserState_GroupRemoved = 14,
02157 GuestUserState_Elevated = 15,
02158 };
02159
02167 enum FileSeekType
02168 {
02173 FileSeekType_Set = 0,
02178 FileSeekType_Current = 1,
02179 };
02180
02188 enum ProcessInputFlag
02189 {
02194 ProcessInputFlag_None = 0,
02199 ProcessInputFlag_EndOfFile = 1,
02200 };
02201
02210 enum ProcessOutputFlag
02211 {
02216 ProcessOutputFlag_None = 0,
02221 ProcessOutputFlag_StdErr = 1,
02222 };
02223
02231 enum ProcessWaitForFlag
02232 {
02237 ProcessWaitForFlag_None = 0,
02242 ProcessWaitForFlag_Start = 1,
02247 ProcessWaitForFlag_Terminate = 2,
02252 ProcessWaitForFlag_StdIn = 4,
02257 ProcessWaitForFlag_StdOut = 8,
02262 ProcessWaitForFlag_StdErr = 16,
02263 };
02264
02283 enum ProcessWaitResult
02284 {
02289 ProcessWaitResult_None = 0,
02294 ProcessWaitResult_Start = 1,
02299 ProcessWaitResult_Terminate = 2,
02307 ProcessWaitResult_Status = 3,
02312 ProcessWaitResult_Error = 4,
02321 ProcessWaitResult_Timeout = 5,
02328 ProcessWaitResult_StdIn = 6,
02333 ProcessWaitResult_StdOut = 7,
02338 ProcessWaitResult_StdErr = 8,
02346 ProcessWaitResult_WaitFlagNotSupported = 9,
02347 };
02348
02356 enum CopyFileFlag
02357 {
02362 CopyFileFlag_None = 0,
02368 CopyFileFlag_Recursive = 1,
02375 CopyFileFlag_Update = 2,
02380 CopyFileFlag_FollowLinks = 4,
02381 };
02382
02390 enum DirectoryCreateFlag
02391 {
02396 DirectoryCreateFlag_None = 0,
02401 DirectoryCreateFlag_Parents = 1,
02402 };
02403
02411 enum DirectoryRemoveRecFlag
02412 {
02417 DirectoryRemoveRecFlag_None = 0,
02422 DirectoryRemoveRecFlag_ContentAndDir = 1,
02427 DirectoryRemoveRecFlag_ContentOnly = 2,
02428 };
02429
02437 enum PathRenameFlag
02438 {
02443 PathRenameFlag_None = 0,
02448 PathRenameFlag_NoReplace = 1,
02453 PathRenameFlag_Replace = 2,
02458 PathRenameFlag_NoSymlinks = 4,
02459 };
02460
02468 enum ProcessCreateFlag
02469 {
02474 ProcessCreateFlag_None = 0,
02480 ProcessCreateFlag_WaitForProcessStartOnly = 1,
02485 ProcessCreateFlag_IgnoreOrphanedProcesses = 2,
02490 ProcessCreateFlag_Hidden = 4,
02495 ProcessCreateFlag_NoProfile = 8,
02500 ProcessCreateFlag_WaitForStdOut = 16,
02505 ProcessCreateFlag_WaitForStdErr = 32,
02510 ProcessCreateFlag_ExpandArguments = 64,
02511 };
02512
02520 enum ProcessPriority
02521 {
02526 ProcessPriority_Invalid = 0,
02531 ProcessPriority_Default = 1,
02532 };
02533
02541 enum SymlinkType
02542 {
02547 SymlinkType_Unknown = 0,
02552 SymlinkType_Directory = 1,
02557 SymlinkType_File = 2,
02558 };
02559
02567 enum SymlinkReadFlag
02568 {
02573 SymlinkReadFlag_None = 0,
02578 SymlinkReadFlag_NoSymlinks = 1,
02579 };
02580
02588 enum ProcessStatus
02589 {
02594 ProcessStatus_Undefined = 0,
02599 ProcessStatus_Starting = 10,
02604 ProcessStatus_Started = 100,
02609 ProcessStatus_Paused = 110,
02614 ProcessStatus_Terminating = 480,
02619 ProcessStatus_TerminatedNormally = 500,
02624 ProcessStatus_TerminatedSignal = 510,
02629 ProcessStatus_TerminatedAbnormally = 511,
02634 ProcessStatus_TimedOutKilled = 512,
02639 ProcessStatus_TimedOutAbnormally = 513,
02644 ProcessStatus_Down = 600,
02649 ProcessStatus_Error = 800,
02650 };
02651
02659 enum ProcessInputStatus
02660 {
02665 ProcessInputStatus_Undefined = 0,
02670 ProcessInputStatus_Broken = 1,
02675 ProcessInputStatus_Available = 10,
02680 ProcessInputStatus_Written = 50,
02685 ProcessInputStatus_Overflow = 100,
02686 };
02687
02695 enum FileStatus
02696 {
02701 FileStatus_Undefined = 0,
02706 FileStatus_Opening = 10,
02711 FileStatus_Open = 100,
02716 FileStatus_Closing = 150,
02721 FileStatus_Closed = 200,
02726 FileStatus_Down = 600,
02731 FileStatus_Error = 800,
02732 };
02733
02741 enum FsObjType
02742 {
02747 FsObjType_Undefined = 0,
02752 FsObjType_FIFO = 1,
02757 FsObjType_DevChar = 10,
02762 FsObjType_DevBlock = 11,
02767 FsObjType_Directory = 50,
02772 FsObjType_File = 80,
02777 FsObjType_Symlink = 100,
02782 FsObjType_Socket = 200,
02787 FsObjType_Whiteout = 400,
02788 };
02789
02797 enum DragAndDropAction
02798 {
02803 DragAndDropAction_Ignore = 0,
02808 DragAndDropAction_Copy = 1,
02813 DragAndDropAction_Move = 2,
02818 DragAndDropAction_Link = 3,
02819 };
02820
02828 enum DirectoryOpenFlag
02829 {
02834 DirectoryOpenFlag_None = 0,
02839 DirectoryOpenFlag_NoSymlinks = 1,
02840 };
02841
02851 enum MediumState
02852 {
02860 MediumState_NotCreated = 0,
02869 MediumState_Created = 1,
02877 MediumState_LockedRead = 2,
02885 MediumState_LockedWrite = 3,
02895 MediumState_Inaccessible = 4,
02902 MediumState_Creating = 5,
02909 MediumState_Deleting = 6,
02910 };
02911
02922 enum MediumType
02923 {
02931 MediumType_Normal = 0,
02939 MediumType_Immutable = 1,
02947 MediumType_Writethrough = 2,
02956 MediumType_Shareable = 3,
02965 MediumType_Readonly = 4,
02977 MediumType_MultiAttach = 5,
02978 };
02979
02989 enum MediumVariant
02990 {
02997 MediumVariant_Standard = 0,
03004 MediumVariant_VmdkSplit2G = 0x01,
03011 MediumVariant_VmdkRawDisk = 0x02,
03019 MediumVariant_VmdkStreamOptimized = 0x04,
03026 MediumVariant_VmdkESX = 0x08,
03033 MediumVariant_Fixed = 0x10000,
03040 MediumVariant_Diff = 0x20000,
03048 MediumVariant_NoCreateDir = 0x40000000,
03049 };
03050
03051 enum DataType
03052 {
03053 DataType_Int32 = 0,
03054 DataType_Int8 = 1,
03055 DataType_String = 2,
03056 };
03057
03058 enum DataFlags
03059 {
03060 DataFlags_None = 0x00,
03061 DataFlags_Mandatory = 0x01,
03062 DataFlags_Expert = 0x02,
03063 DataFlags_Array = 0x04,
03064 DataFlags_FlagMask = 0x07,
03065 };
03066
03074 enum MediumFormatCapabilities
03075 {
03082 MediumFormatCapabilities_Uuid = 0x01,
03089 MediumFormatCapabilities_CreateFixed = 0x02,
03097 MediumFormatCapabilities_CreateDynamic = 0x04,
03104 MediumFormatCapabilities_CreateSplit2G = 0x08,
03111 MediumFormatCapabilities_Differencing = 0x10,
03118 MediumFormatCapabilities_Asynchronous = 0x20,
03128 MediumFormatCapabilities_File = 0x40,
03137 MediumFormatCapabilities_Properties = 0x80,
03144 MediumFormatCapabilities_TcpNetworking = 0x100,
03151 MediumFormatCapabilities_VFS = 0x200,
03152 MediumFormatCapabilities_CapabilityMask = 0x3FF,
03153 };
03154
03162 enum MouseButtonState
03163 {
03164 MouseButtonState_LeftButton = 0x01,
03165 MouseButtonState_RightButton = 0x02,
03166 MouseButtonState_MiddleButton = 0x04,
03167 MouseButtonState_WheelUp = 0x08,
03168 MouseButtonState_WheelDown = 0x10,
03169 MouseButtonState_XButton1 = 0x20,
03170 MouseButtonState_XButton2 = 0x40,
03171 MouseButtonState_MouseStateMask = 0x7F,
03172 };
03173
03181 enum TouchContactState
03182 {
03187 TouchContactState_None = 0x00,
03192 TouchContactState_InContact = 0x01,
03199 TouchContactState_InRange = 0x02,
03200 TouchContactState_ContactStateMask = 0x03,
03201 };
03202
03213 enum FramebufferPixelFormat
03214 {
03222 FramebufferPixelFormat_Opaque = 0,
03230 FramebufferPixelFormat_FOURCC_RGB = 0x32424752,
03231 };
03232
03240 enum NetworkAttachmentType
03241 {
03246 NetworkAttachmentType_Null = 0,
03247 NetworkAttachmentType_NAT = 1,
03248 NetworkAttachmentType_Bridged = 2,
03249 NetworkAttachmentType_Internal = 3,
03250 NetworkAttachmentType_HostOnly = 4,
03251 NetworkAttachmentType_Generic = 5,
03252 NetworkAttachmentType_NATNetwork = 6,
03253 };
03254
03262 enum NetworkAdapterType
03263 {
03268 NetworkAdapterType_Null = 0,
03273 NetworkAdapterType_Am79C970A = 1,
03278 NetworkAdapterType_Am79C973 = 2,
03283 NetworkAdapterType_I82540EM = 3,
03288 NetworkAdapterType_I82543GC = 4,
03293 NetworkAdapterType_I82545EM = 5,
03298 NetworkAdapterType_Virtio = 6,
03299 };
03300
03308 enum NetworkAdapterPromiscModePolicy
03309 {
03314 NetworkAdapterPromiscModePolicy_Deny = 1,
03322 NetworkAdapterPromiscModePolicy_AllowNetwork = 2,
03330 NetworkAdapterPromiscModePolicy_AllowAll = 3,
03331 };
03332
03341 enum PortMode
03342 {
03347 PortMode_Disconnected = 0,
03352 PortMode_HostPipe = 1,
03357 PortMode_HostDevice = 2,
03362 PortMode_RawFile = 3,
03363 };
03364
03372 enum USBControllerType
03373 {
03378 USBControllerType_Null = 0,
03379 USBControllerType_OHCI = 1,
03380 USBControllerType_EHCI = 2,
03385 USBControllerType_Last = 3,
03386 };
03387
03426 enum USBDeviceState
03427 {
03434 USBDeviceState_NotSupported = 0,
03442 USBDeviceState_Unavailable = 1,
03449 USBDeviceState_Busy = 2,
03457 USBDeviceState_Available = 3,
03465 USBDeviceState_Held = 4,
03473 USBDeviceState_Captured = 5,
03474 };
03475
03485 enum USBDeviceFilterAction
03486 {
03491 USBDeviceFilterAction_Null = 0,
03496 USBDeviceFilterAction_Ignore = 1,
03501 USBDeviceFilterAction_Hold = 2,
03502 };
03503
03511 enum AudioDriverType
03512 {
03517 AudioDriverType_Null = 0,
03522 AudioDriverType_WinMM = 1,
03527 AudioDriverType_OSS = 2,
03532 AudioDriverType_ALSA = 3,
03537 AudioDriverType_DirectSound = 4,
03542 AudioDriverType_CoreAudio = 5,
03547 AudioDriverType_MMPM = 6,
03552 AudioDriverType_Pulse = 7,
03557 AudioDriverType_SolAudio = 8,
03558 };
03559
03567 enum AudioControllerType
03568 {
03569 AudioControllerType_AC97 = 0,
03570 AudioControllerType_SB16 = 1,
03571 AudioControllerType_HDA = 2,
03572 };
03573
03581 enum AuthType
03582 {
03587 AuthType_Null = 0,
03588 AuthType_External = 1,
03589 AuthType_Guest = 2,
03590 };
03591
03599 enum Reason
03600 {
03605 Reason_Unspecified = 0,
03610 Reason_HostSuspend = 1,
03615 Reason_HostResume = 2,
03620 Reason_HostBatteryLow = 3,
03621 };
03622
03631 enum StorageBus
03632 {
03637 StorageBus_Null = 0,
03638 StorageBus_IDE = 1,
03639 StorageBus_SATA = 2,
03640 StorageBus_SCSI = 3,
03641 StorageBus_Floppy = 4,
03642 StorageBus_SAS = 5,
03643 };
03644
03653 enum StorageControllerType
03654 {
03659 StorageControllerType_Null = 0,
03664 StorageControllerType_LsiLogic = 1,
03669 StorageControllerType_BusLogic = 2,
03674 StorageControllerType_IntelAhci = 3,
03679 StorageControllerType_PIIX3 = 4,
03684 StorageControllerType_PIIX4 = 5,
03689 StorageControllerType_ICH6 = 6,
03694 StorageControllerType_I82078 = 7,
03699 StorageControllerType_LsiLogicSas = 8,
03700 };
03701
03709 enum ChipsetType
03710 {
03715 ChipsetType_Null = 0,
03720 ChipsetType_PIIX3 = 1,
03725 ChipsetType_ICH9 = 2,
03726 };
03727
03733 enum NATAliasMode
03734 {
03739 NATAliasMode_AliasLog = 0x1,
03744 NATAliasMode_AliasProxyOnly = 0x02,
03749 NATAliasMode_AliasUseSamePorts = 0x04,
03750 };
03751
03757 enum NATProtocol
03758 {
03763 NATProtocol_UDP = 0,
03768 NATProtocol_TCP = 1,
03769 };
03770
03778 enum BandwidthGroupType
03779 {
03786 BandwidthGroupType_Null = 0,
03793 BandwidthGroupType_Disk = 1,
03800 BandwidthGroupType_Network = 2,
03801 };
03802
03811 enum VBoxEventType
03812 {
03819 VBoxEventType_Invalid = 0,
03828 VBoxEventType_Any = 1,
03836 VBoxEventType_Vetoable = 2,
03844 VBoxEventType_MachineEvent = 3,
03852 VBoxEventType_SnapshotEvent = 4,
03861 VBoxEventType_InputEvent = 5,
03868 VBoxEventType_LastWildcard = 31,
03875 VBoxEventType_OnMachineStateChanged = 32,
03882 VBoxEventType_OnMachineDataChanged = 33,
03889 VBoxEventType_OnExtraDataChanged = 34,
03896 VBoxEventType_OnExtraDataCanChange = 35,
03903 VBoxEventType_OnMediumRegistered = 36,
03910 VBoxEventType_OnMachineRegistered = 37,
03917 VBoxEventType_OnSessionStateChanged = 38,
03924 VBoxEventType_OnSnapshotTaken = 39,
03931 VBoxEventType_OnSnapshotDeleted = 40,
03938 VBoxEventType_OnSnapshotChanged = 41,
03945 VBoxEventType_OnGuestPropertyChanged = 42,
03952 VBoxEventType_OnMousePointerShapeChanged = 43,
03959 VBoxEventType_OnMouseCapabilityChanged = 44,
03966 VBoxEventType_OnKeyboardLedsChanged = 45,
03973 VBoxEventType_OnStateChanged = 46,
03980 VBoxEventType_OnAdditionsStateChanged = 47,
03987 VBoxEventType_OnNetworkAdapterChanged = 48,
03994 VBoxEventType_OnSerialPortChanged = 49,
04001 VBoxEventType_OnParallelPortChanged = 50,
04008 VBoxEventType_OnStorageControllerChanged = 51,
04015 VBoxEventType_OnMediumChanged = 52,
04022 VBoxEventType_OnVRDEServerChanged = 53,
04029 VBoxEventType_OnUSBControllerChanged = 54,
04036 VBoxEventType_OnUSBDeviceStateChanged = 55,
04043 VBoxEventType_OnSharedFolderChanged = 56,
04050 VBoxEventType_OnRuntimeError = 57,
04057 VBoxEventType_OnCanShowWindow = 58,
04064 VBoxEventType_OnShowWindow = 59,
04071 VBoxEventType_OnCPUChanged = 60,
04078 VBoxEventType_OnVRDEServerInfoChanged = 61,
04085 VBoxEventType_OnEventSourceChanged = 62,
04092 VBoxEventType_OnCPUExecutionCapChanged = 63,
04099 VBoxEventType_OnGuestKeyboard = 64,
04106 VBoxEventType_OnGuestMouse = 65,
04113 VBoxEventType_OnNATRedirect = 66,
04120 VBoxEventType_OnHostPCIDevicePlug = 67,
04127 VBoxEventType_OnVBoxSVCAvailabilityChanged = 68,
04134 VBoxEventType_OnBandwidthGroupChanged = 69,
04141 VBoxEventType_OnGuestMonitorChanged = 70,
04148 VBoxEventType_OnStorageDeviceChanged = 71,
04155 VBoxEventType_OnClipboardModeChanged = 72,
04162 VBoxEventType_OnDragAndDropModeChanged = 73,
04169 VBoxEventType_OnNATNetworkChanged = 74,
04176 VBoxEventType_OnNATNetworkStartStop = 75,
04183 VBoxEventType_OnNATNetworkAlter = 76,
04190 VBoxEventType_OnNATNetworkCreationDeletion = 77,
04197 VBoxEventType_OnNATNetworkSetting = 78,
04204 VBoxEventType_OnNATNetworkPortForward = 79,
04211 VBoxEventType_OnGuestSessionStateChanged = 80,
04218 VBoxEventType_OnGuestSessionRegistered = 81,
04225 VBoxEventType_OnGuestProcessRegistered = 82,
04232 VBoxEventType_OnGuestProcessStateChanged = 83,
04239 VBoxEventType_OnGuestProcessInputNotify = 84,
04246 VBoxEventType_OnGuestProcessOutput = 85,
04253 VBoxEventType_OnGuestFileRegistered = 86,
04260 VBoxEventType_OnGuestFileStateChanged = 87,
04267 VBoxEventType_OnGuestFileOffsetChanged = 88,
04275 VBoxEventType_OnGuestFileRead = 89,
04283 VBoxEventType_OnGuestFileWrite = 90,
04290 VBoxEventType_OnVideoCaptureChanged = 91,
04297 VBoxEventType_OnGuestUserStateChanged = 92,
04304 VBoxEventType_OnGuestMultiTouch = 93,
04311 VBoxEventType_OnHostNameResolutionConfigurationChange = 94,
04318 VBoxEventType_Last = 95,
04319 };
04320
04332 enum GuestMouseEventMode
04333 {
04340 GuestMouseEventMode_Relative = 0,
04347 GuestMouseEventMode_Absolute = 1,
04348 };
04349
04357 enum GuestMonitorChangedEventType
04358 {
04365 GuestMonitorChangedEventType_Enabled = 0,
04372 GuestMonitorChangedEventType_Disabled = 1,
04379 GuestMonitorChangedEventType_NewOrigin = 2,
04380 };
04381
04415 interface IVirtualBoxErrorInfo : $errorinfo
04416 {
04434 readonly attribute long resultCode;
04435
04442 readonly attribute long resultDetail;
04443
04455 readonly attribute wstringUUID interfaceID;
04456
04467 readonly attribute wstring component;
04468
04479 readonly attribute wstring text;
04480
04491 readonly attribute IVirtualBoxErrorInfo next;
04492
04493 };
04494
04495 interface INATNetwork : $unknown
04496 {
04505 attribute wstring networkName;
04506
04507 attribute boolean enabled;
04508
04517 attribute wstring network;
04518
04525 readonly attribute wstring gateway;
04526
04532 attribute boolean IPv6Enabled;
04533
04541 attribute wstring IPv6Prefix;
04542
04543 attribute boolean advertiseDefaultIPv6RouteEnabled;
04544
04545 attribute boolean needDhcpServer;
04546
04547 readonly attribute IEventSource eventSource;
04548
04555 readonly attribute wstring[] portForwardRules4;
04556
04561 readonly attribute wstring[] localMappings;
04562
04567 attribute long loopbackIp6;
04568
04574 readonly attribute wstring[] portForwardRules6;
04575
04579 void addLocalMapping (
04580 in wstring hostid,
04581 in long offset
04582 );
04583
04584 void addPortForwardRule (
04585 in boolean isIpv6,
04586 in wstring ruleName,
04587 in NATProtocol proto,
04588 in wstring hostIP,
04589 in unsigned short hostPort,
04590 in wstring guestIP,
04591 in unsigned short guestPort
04592 );
04593
04594 void removePortForwardRule (
04595 in boolean iSipv6,
04596 in wstring ruleName
04597 );
04598
04599 void start (
04600 in wstring trunkType
04601 );
04602
04603 void stop();
04604
04605 };
04606
04617 interface IDHCPServer : $unknown
04618 {
04619 readonly attribute IEventSource eventSource;
04620
04626 attribute boolean enabled;
04627
04633 readonly attribute wstring IPAddress;
04634
04640 readonly attribute wstring networkMask;
04641
04647 readonly attribute wstring networkName;
04648
04654 readonly attribute wstring lowerIP;
04655
04661 readonly attribute wstring upperIP;
04662
04663 readonly attribute wstring[] globalOptions;
04664
04665 readonly attribute wstring[] vmConfigs;
04666
04667 void addGlobalOption (
04668 in DhcpOpt option,
04669 in wstring value
04670 );
04671
04672 void addVmSlotOption (
04673 in wstring vmname,
04674 in long slot,
04675 in DhcpOpt option,
04676 in wstring value
04677 );
04678
04679 void removeVmSlotOptions (
04680 in wstring vmname,
04681 in long slot
04682 );
04683
04684 void getVmSlotOptions (
04685 in wstring vmname,
04686 in long slot,
04687 [retval] out wstring[] option
04688 );
04689
04690 void getMacOptions (
04691 in wstring mac,
04692 [retval] out wstring[] option
04693 );
04694
04723 void setConfiguration (
04724 in wstring IPAddress,
04725 in wstring networkMask,
04726 in wstring FromIPAddress,
04727 in wstring ToIPAddress
04728 );
04729
04754 void start (
04755 in wstring networkName,
04756 in wstring trunkName,
04757 in wstring trunkType
04758 );
04759
04772 void stop();
04773
04774 };
04775
04794 interface IVirtualBox : $unknown
04795 {
04808 readonly attribute wstring version;
04809
04817 readonly attribute wstring versionNormalized;
04818
04824 readonly attribute unsigned long revision;
04825
04835 readonly attribute wstring packageType;
04836
04848 readonly attribute wstring APIVersion;
04849
04865 readonly attribute wstring homeFolder;
04866
04874 readonly attribute wstring settingsFilePath;
04875
04879 readonly attribute IHost host;
04880
04884 readonly attribute ISystemProperties systemProperties;
04885
04891 readonly attribute IMachine[] machines;
04892
04902 readonly attribute wstring[] machineGroups;
04903
04913 readonly attribute IMedium[] hardDisks;
04914
04920 readonly attribute IMedium[] DVDImages;
04921
04927 readonly attribute IMedium[] floppyImages;
04928
04929 readonly attribute IProgress[] progressOperations;
04930
04931 readonly attribute IGuestOSType[] guestOSTypes;
04932
04949 readonly attribute ISharedFolder[] sharedFolders;
04950
04956 readonly attribute IPerformanceCollector performanceCollector;
04957
04963 readonly attribute IDHCPServer[] DHCPServers;
04964
04965 readonly attribute INATNetwork[] NATNetworks;
04966
04972 readonly attribute IEventSource eventSource;
04973
04979 readonly attribute IExtPackManager extensionPackManager;
04980
04986 readonly attribute wstring[] internalNetworks;
04987
04993 readonly attribute wstring[] genericNetworkDrivers;
04994
05045 void composeMachineFilename (
05046 in wstring name,
05047 in wstring group,
05048 in wstring createFlags,
05049 in wstring baseFolder,
05050 [retval] out wstring file
05051 );
05052
05159 void createMachine (
05160 in wstring settingsFile,
05161 in wstring name,
05162 in wstring[] groups,
05163 in wstring osTypeId,
05164 in wstring flags,
05165 [retval] out IMachine machine
05166 );
05167
05198 void openMachine (
05199 in wstring settingsFile,
05200 [retval] out IMachine machine
05201 );
05202
05234 void registerMachine (
05235 in IMachine machine
05236 );
05237
05258 void findMachine (
05259 in wstring nameOrId,
05260 [retval] out IMachine machine
05261 );
05262
05274 void getMachinesByGroups (
05275 in wstring[] groups,
05276 [retval] out IMachine[] machines
05277 );
05278
05288 void getMachineStates (
05289 in IMachine[] machines,
05290 [retval] out MachineState[] states
05291 );
05292
05302 void createAppliance (
05303 [retval] out IAppliance appliance
05304 );
05305
05368 void createHardDisk (
05369 in wstring format,
05370 in wstring location,
05371 [retval] out IMedium medium
05372 );
05373
05479 void openMedium (
05480 in wstring location,
05481 in DeviceType deviceType,
05482 in AccessMode accessMode,
05483 in boolean forceNewUuid,
05484 [retval] out IMedium medium
05485 );
05486
05515 void getGuestOSType (
05516 in wstringUUID id,
05517 [retval] out IGuestOSType type
05518 );
05519
05542 void createSharedFolder (
05543 in wstring name,
05544 in wstring hostPath,
05545 in boolean writable,
05546 in boolean automount
05547 );
05548
05563 void removeSharedFolder (
05564 in wstring name
05565 );
05566
05575 void getExtraDataKeys (
05576 [retval] out wstring[] keys
05577 );
05578
05607 void getExtraData (
05608 in wstring key,
05609 [retval] out wstring value
05610 );
05611
05661 void setExtraData (
05662 in wstring key,
05663 in wstring value
05664 );
05665
05684 void setSettingsSecret (
05685 in wstring password
05686 );
05687
05704 void createDHCPServer (
05705 in wstring name,
05706 [retval] out IDHCPServer server
05707 );
05708
05725 void findDHCPServerByNetworkName (
05726 in wstring name,
05727 [retval] out IDHCPServer server
05728 );
05729
05744 void removeDHCPServer (
05745 in IDHCPServer server
05746 );
05747
05748 void createNATNetwork (
05749 in wstring networkName,
05750 [retval] out INATNetwork network
05751 );
05752
05753 void findNATNetworkByName (
05754 in wstring networkName,
05755 [retval] out INATNetwork network
05756 );
05757
05758 void removeNATNetwork (
05759 in INATNetwork network
05760 );
05761
05786 void checkFirmwarePresent (
05787 in FirmwareType firmwareType,
05788 in wstring version,
05789 out wstring url,
05790 out wstring file,
05791 [retval] out boolean result
05792 );
05793
05794 };
05795
05806 interface IVFSExplorer : $unknown
05807 {
05811 readonly attribute wstring path;
05812
05816 readonly attribute VFSType type;
05817
05825 void update (
05826 [retval] out IProgress progress
05827 );
05828
05836 void cd (
05837 in wstring dir,
05838 [retval] out IProgress progress
05839 );
05840
05846 void cdUp (
05847 [retval] out IProgress progress
05848 );
05849
05862 void entryList (
05863 out wstring[] names,
05864 out unsigned long[] types,
05865 out long long[] sizes,
05866 out unsigned long[] modes
05867 );
05868
05877 void exists (
05878 in wstring[] names,
05879 [retval] out wstring[] exists
05880 );
05881
05889 void remove (
05890 in wstring[] names,
05891 [retval] out IProgress progress
05892 );
05893
05894 };
05895
05961 interface IAppliance : $unknown
05962 {
05970 readonly attribute wstring path;
05971
06002 readonly attribute wstring[] disks;
06003
06011 readonly attribute IVirtualSystemDescription[] virtualSystemDescriptions;
06012
06020 readonly attribute wstring[] machines;
06021
06038 void read (
06039 in wstring file,
06040 [retval] out IProgress progress
06041 );
06042
06059 void interpret();
06060
06083 void importMachines (
06084 in ImportOptions[] options,
06085 [retval] out IProgress progress
06086 );
06087
06095 void createVFSExplorer (
06096 in wstring URI,
06097 [retval] out IVFSExplorer explorer
06098 );
06099
06126 void write (
06127 in wstring format,
06128 in ExportOptions[] options,
06129 in wstring path,
06130 [retval] out IProgress progress
06131 );
06132
06138 void getWarnings (
06139 [retval] out wstring[] warnings
06140 );
06141
06142 };
06143
06155 interface IVirtualSystemDescription : $unknown
06156 {
06160 readonly attribute unsigned long count;
06161
06285 void getDescription (
06286 out VirtualSystemDescriptionType[] types,
06287 out wstring[] refs,
06288 out wstring[] OVFValues,
06289 out wstring[] VBoxValues,
06290 out wstring[] extraConfigValues
06291 );
06292
06309 void getDescriptionByType (
06310 in VirtualSystemDescriptionType type,
06311 out VirtualSystemDescriptionType[] types,
06312 out wstring[] refs,
06313 out wstring[] OVFValues,
06314 out wstring[] VBoxValues,
06315 out wstring[] extraConfigValues
06316 );
06317
06329 void getValuesByType (
06330 in VirtualSystemDescriptionType type,
06331 in VirtualSystemDescriptionValueType which,
06332 [retval] out wstring[] values
06333 );
06334
06360 void setFinalValues (
06361 in boolean[] enabled,
06362 in wstring[] VBoxValues,
06363 in wstring[] extraConfigValues
06364 );
06365
06380 void addDescription (
06381 in VirtualSystemDescriptionType type,
06382 in wstring VBoxValue,
06383 in wstring extraConfigValue
06384 );
06385
06386 };
06387
06388 interface IInternalMachineControl : $unknown
06389 {
06396 void setRemoveSavedStateFile (
06397 in boolean remove
06398 );
06399
06411 void updateState (
06412 in MachineState state
06413 );
06414
06426 void beginPowerUp (
06427 in IProgress progress
06428 );
06429
06439 void endPowerUp (
06440 in long result
06441 );
06442
06454 void beginPoweringDown (
06455 out IProgress progress
06456 );
06457
06487 void endPoweringDown (
06488 in long result,
06489 in wstring errMsg
06490 );
06491
06505 void runUSBDeviceFilters (
06506 in IUSBDevice device,
06507 out boolean matched,
06508 out unsigned long maskedInterfaces
06509 );
06510
06519 void captureUSBDevice (
06520 in wstringUUID id
06521 );
06522
06538 void detachUSBDevice (
06539 in wstringUUID id,
06540 in boolean done
06541 );
06542
06551 void autoCaptureUSBDevices();
06552
06568 void detachAllUSBDevices (
06569 in boolean done
06570 );
06571
06586 void onSessionEnd (
06587 in ISession session,
06588 [retval] out IProgress progress
06589 );
06590
06606 void beginSavingState (
06607 out IProgress progress,
06608 out wstring stateFilePath
06609 );
06610
06640 void endSavingState (
06641 in long result,
06642 in wstring errMsg
06643 );
06644
06659 void adoptSavedState (
06660 in wstring savedStateFile
06661 );
06662
06711 void beginTakingSnapshot (
06712 in IConsole initiator,
06713 in wstring name,
06714 in wstring description,
06715 in IProgress consoleProgress,
06716 in boolean fTakingSnapshotOnline,
06717 out wstring stateFilePath
06718 );
06719
06729 void endTakingSnapshot (
06730 in boolean success
06731 );
06732
06761 void deleteSnapshot (
06762 in IConsole initiator,
06763 in wstringUUID startId,
06764 in wstringUUID endId,
06765 in boolean deleteAllChildren,
06766 out MachineState machineState,
06767 [retval] out IProgress progress
06768 );
06769
06776 void finishOnlineMergeMedium();
06777
06791 void restoreSnapshot (
06792 in IConsole initiator,
06793 in ISnapshot snapshot,
06794 out MachineState machineState,
06795 [retval] out IProgress progress
06796 );
06797
06824 void pullGuestProperties (
06825 out wstring[] names,
06826 out wstring[] values,
06827 out long long[] timestamps,
06828 out wstring[] flags
06829 );
06830
06852 void pushGuestProperty (
06853 in wstring name,
06854 in wstring value,
06855 in long long timestamp,
06856 in wstring flags
06857 );
06858
06870 void lockMedia();
06871
06881 void unlockMedia();
06882
06898 void ejectMedium (
06899 in IMediumAttachment attachment,
06900 [retval] out IMediumAttachment newAttachment
06901 );
06902
06943 void reportVmStatistics (
06944 in unsigned long validStats,
06945 in unsigned long cpuUser,
06946 in unsigned long cpuKernel,
06947 in unsigned long cpuIdle,
06948 in unsigned long memTotal,
06949 in unsigned long memFree,
06950 in unsigned long memBalloon,
06951 in unsigned long memShared,
06952 in unsigned long memCache,
06953 in unsigned long pagedTotal,
06954 in unsigned long memAllocTotal,
06955 in unsigned long memFreeTotal,
06956 in unsigned long memBalloonTotal,
06957 in unsigned long memSharedTotal,
06958 in unsigned long vmNetRx,
06959 in unsigned long vmNetTx
06960 );
06961
06962 };
06963
06972 interface IBIOSSettings : $unknown
06973 {
06977 attribute boolean logoFadeIn;
06978
06982 attribute boolean logoFadeOut;
06983
06987 attribute unsigned long logoDisplayTime;
06988
06995 attribute wstring logoImagePath;
06996
07000 attribute BIOSBootMenuMode bootMenuMode;
07001
07005 attribute boolean ACPIEnabled;
07006
07013 attribute boolean IOAPICEnabled;
07014
07024 attribute long long timeOffset;
07025
07032 attribute boolean PXEDebugEnabled;
07033
07042 readonly attribute wstring nonVolatileStorageFile;
07043
07044 };
07045
07053 interface IPCIAddress : $unknown
07054 {
07060 attribute short bus;
07061
07067 attribute short device;
07068
07074 attribute short devFunction;
07075
07081 void asLong (
07082 [retval] out long result
07083 );
07084
07090 void fromLong (
07091 in long number
07092 );
07093
07094 };
07095
07103 interface IPCIDeviceAttachment : $unknown
07104 {
07110 readonly attribute wstring name;
07111
07117 readonly attribute boolean isPhysicalDevice;
07118
07124 readonly attribute long hostAddress;
07125
07131 readonly attribute long guestAddress;
07132
07133 };
07134
07175 interface IMachine : $unknown
07176 {
07180 readonly attribute IVirtualBox parent;
07181
07185 attribute octet[] icon;
07186
07236 readonly attribute boolean accessible;
07237
07249 readonly attribute IVirtualBoxErrorInfo accessError;
07250
07290 attribute wstring name;
07291
07302 attribute wstring description;
07303
07307 readonly attribute wstringUUID id;
07308
07319 attribute wstring[] groups;
07320
07335 attribute wstring OSTypeId;
07336
07340 attribute wstring hardwareVersion;
07341
07351 attribute wstringUUID hardwareUUID;
07352
07356 attribute unsigned long CPUCount;
07357
07363 attribute boolean CPUHotPlugEnabled;
07364
07372 attribute unsigned long CPUExecutionCap;
07373
07377 attribute unsigned long memorySize;
07378
07382 attribute unsigned long memoryBalloonSize;
07383
07390 attribute boolean pageFusionEnabled;
07391
07395 attribute GraphicsControllerType graphicsControllerType;
07396
07400 attribute unsigned long VRAMSize;
07401
07407 attribute boolean accelerate3DEnabled;
07408
07414 attribute boolean accelerate2DVideoEnabled;
07415
07426 attribute unsigned long monitorCount;
07427
07433 attribute boolean videoCaptureEnabled;
07434
07440 attribute boolean[] videoCaptureScreens;
07441
07455 attribute wstring videoCaptureFile;
07456
07464 attribute unsigned long videoCaptureWidth;
07465
07473 attribute unsigned long videoCaptureHeight;
07474
07483 attribute unsigned long videoCaptureRate;
07484
07494 attribute unsigned long videoCaptureFPS;
07495
07499 readonly attribute IBIOSSettings BIOSSettings;
07500
07505 attribute FirmwareType firmwareType;
07506
07512 attribute PointingHIDType pointingHIDType;
07513
07519 attribute KeyboardHIDType keyboardHIDType;
07520
07527 attribute boolean HPETEnabled;
07528
07532 attribute ChipsetType chipsetType;
07533
07567 attribute wstring snapshotFolder;
07568
07572 readonly attribute IVRDEServer VRDEServer;
07573
07574 attribute boolean emulatedUSBCardReaderEnabled;
07575
07579 readonly attribute IMediumAttachment[] mediumAttachments;
07580
07592 readonly attribute IUSBController[] USBControllers;
07593
07605 readonly attribute IUSBDeviceFilters USBDeviceFilters;
07606
07610 readonly attribute IAudioAdapter audioAdapter;
07611
07615 readonly attribute IStorageController[] storageControllers;
07616
07622 readonly attribute wstring settingsFilePath;
07623
07648 readonly attribute boolean settingsModified;
07649
07653 readonly attribute SessionState sessionState;
07654
07667 readonly attribute wstring sessionType;
07668
07678 readonly attribute unsigned long sessionPID;
07679
07683 readonly attribute MachineState state;
07684
07691 readonly attribute long long lastStateChange;
07692
07704 readonly attribute wstring stateFilePath;
07705
07715 readonly attribute wstring logFolder;
07716
07727 readonly attribute ISnapshot currentSnapshot;
07728
07735 readonly attribute unsigned long snapshotCount;
07736
07768 readonly attribute boolean currentStateModified;
07769
07781 readonly attribute ISharedFolder[] sharedFolders;
07782
07789 attribute ClipboardMode clipboardMode;
07790
07796 attribute DragAndDropMode dragAndDropMode;
07797
07805 attribute wstring guestPropertyNotificationPatterns;
07806
07815 attribute boolean teleporterEnabled;
07816
07827 attribute unsigned long teleporterPort;
07828
07835 attribute wstring teleporterAddress;
07836
07847 attribute wstring teleporterPassword;
07848
07856 attribute FaultToleranceState faultToleranceState;
07857
07864 attribute unsigned long faultTolerancePort;
07865
07871 attribute wstring faultToleranceAddress;
07872
07880 attribute wstring faultTolerancePassword;
07881
07887 attribute unsigned long faultToleranceSyncInterval;
07888
07896 attribute boolean RTCUseUTC;
07897
07904 attribute boolean IOCacheEnabled;
07905
07911 attribute unsigned long IOCacheSize;
07912
07922 readonly attribute IPCIDeviceAttachment[] PCIDeviceAssignments;
07923
07929 readonly attribute IBandwidthControl bandwidthControl;
07930
07939 attribute boolean tracingEnabled;
07940
07955 attribute wstring tracingConfig;
07956
07969 attribute boolean allowTracingToAccessVM;
07970
07976 attribute boolean autostartEnabled;
07977
07983 attribute unsigned long autostartDelay;
07984
07990 attribute AutostopType autostopType;
07991
08007 attribute wstring defaultFrontend;
08008
08014 readonly attribute boolean USBProxyAvailable;
08015
08121 void lockMachine (
08122 in ISession session,
08123 in LockType lockType
08124 );
08125
08262 void launchVMProcess (
08263 in ISession session,
08264 in wstring type,
08265 in wstring environment,
08266 [retval] out IProgress progress
08267 );
08268
08306 void setBootOrder (
08307 in unsigned long position,
08308 in DeviceType device
08309 );
08310
08345 void getBootOrder (
08346 in unsigned long position,
08347 [retval] out DeviceType device
08348 );
08349
08451 void attachDevice (
08452 in wstring name,
08453 in long controllerPort,
08454 in long device,
08455 in DeviceType type,
08456 in IMedium medium
08457 );
08458
08554 void attachDeviceWithoutMedium (
08555 in wstring name,
08556 in long controllerPort,
08557 in long device,
08558 in DeviceType type
08559 );
08560
08614 void detachDevice (
08615 in wstring name,
08616 in long controllerPort,
08617 in long device
08618 );
08619
08662 void passthroughDevice (
08663 in wstring name,
08664 in long controllerPort,
08665 in long device,
08666 in boolean passthrough
08667 );
08668
08711 void temporaryEjectDevice (
08712 in wstring name,
08713 in long controllerPort,
08714 in long device,
08715 in boolean temporaryEject
08716 );
08717
08763 void nonRotationalDevice (
08764 in wstring name,
08765 in long controllerPort,
08766 in long device,
08767 in boolean nonRotational
08768 );
08769
08815 void setAutoDiscardForDevice (
08816 in wstring name,
08817 in long controllerPort,
08818 in long device,
08819 in boolean discard
08820 );
08821
08871 void setHotPluggableForDevice (
08872 in wstring name,
08873 in long controllerPort,
08874 in long device,
08875 in boolean hotPluggable
08876 );
08877
08918 void setBandwidthGroupForDevice (
08919 in wstring name,
08920 in long controllerPort,
08921 in long device,
08922 in IBandwidthGroup bandwidthGroup
08923 );
08924
08961 void setNoBandwidthGroupForDevice (
08962 in wstring name,
08963 in long controllerPort,
08964 in long device
08965 );
08966
09031 void unmountMedium (
09032 in wstring name,
09033 in long controllerPort,
09034 in long device,
09035 in boolean force
09036 );
09037
09100 void mountMedium (
09101 in wstring name,
09102 in long controllerPort,
09103 in long device,
09104 in IMedium medium,
09105 in boolean force
09106 );
09107
09136 void getMedium (
09137 in wstring name,
09138 in long controllerPort,
09139 in long device,
09140 [retval] out IMedium medium
09141 );
09142
09157 void getMediumAttachmentsOfController (
09158 in wstring name,
09159 [retval] out IMediumAttachment[] mediumAttachments
09160 );
09161
09176 void getMediumAttachment (
09177 in wstring name,
09178 in long controllerPort,
09179 in long device,
09180 [retval] out IMediumAttachment attachment
09181 );
09182
09223 void attachHostPCIDevice (
09224 in long hostAddress,
09225 in long desiredGuestAddress,
09226 in boolean tryToUnbind
09227 );
09228
09269 void detachHostPCIDevice (
09270 in long hostAddress
09271 );
09272
09290 void getNetworkAdapter (
09291 in unsigned long slot,
09292 [retval] out INetworkAdapter adapter
09293 );
09294
09327 void addStorageController (
09328 in wstring name,
09329 in StorageBus connectionType,
09330 [retval] out IStorageController controller
09331 );
09332
09346 void getStorageControllerByName (
09347 in wstring name,
09348 [retval] out IStorageController storageController
09349 );
09350
09364 void getStorageControllerByInstance (
09365 in unsigned long instance,
09366 [retval] out IStorageController storageController
09367 );
09368
09391 void removeStorageController (
09392 in wstring name
09393 );
09394
09416 void setStorageControllerBootable (
09417 in wstring name,
09418 in boolean bootable
09419 );
09420
09443 void addUSBController (
09444 in wstring name,
09445 in USBControllerType type,
09446 [retval] out IUSBController controller
09447 );
09448
09462 void removeUSBController (
09463 in wstring name
09464 );
09465
09479 void getUSBControllerByName (
09480 in wstring name,
09481 [retval] out IUSBController controller
09482 );
09483
09489 void getUSBControllerCountByType (
09490 in USBControllerType type,
09491 [retval] out unsigned long controllers
09492 );
09493
09511 void getSerialPort (
09512 in unsigned long slot,
09513 [retval] out ISerialPort port
09514 );
09515
09533 void getParallelPort (
09534 in unsigned long slot,
09535 [retval] out IParallelPort port
09536 );
09537
09546 void getExtraDataKeys (
09547 [retval] out wstring[] keys
09548 );
09549
09578 void getExtraData (
09579 in wstring key,
09580 [retval] out wstring value
09581 );
09582
09632 void setExtraData (
09633 in wstring key,
09634 in wstring value
09635 );
09636
09658 void getCPUProperty (
09659 in CPUPropertyType property,
09660 [retval] out boolean value
09661 );
09662
09684 void setCPUProperty (
09685 in CPUPropertyType property,
09686 in boolean value
09687 );
09688
09728 void getCPUIDLeaf (
09729 in unsigned long id,
09730 out unsigned long valEax,
09731 out unsigned long valEbx,
09732 out unsigned long valEcx,
09733 out unsigned long valEdx
09734 );
09735
09779 void setCPUIDLeaf (
09780 in unsigned long id,
09781 in unsigned long valEax,
09782 in unsigned long valEbx,
09783 in unsigned long valEcx,
09784 in unsigned long valEdx
09785 );
09786
09804 void removeCPUIDLeaf (
09805 in unsigned long id
09806 );
09807
09813 void removeAllCPUIDLeaves();
09814
09836 void getHWVirtExProperty (
09837 in HWVirtExPropertyType property,
09838 [retval] out boolean value
09839 );
09840
09862 void setHWVirtExProperty (
09863 in HWVirtExPropertyType property,
09864 in boolean value
09865 );
09866
09896 void setSettingsFilePath (
09897 in wstring settingsFilePath,
09898 [retval] out IProgress progress
09899 );
09900
09946 void saveSettings();
09947
09971 void discardSettings();
09972
10056 void unregister (
10057 in CleanupMode cleanupMode,
10058 [retval] out IMedium[] media
10059 );
10060
10117 void deleteConfig (
10118 in IMedium[] media,
10119 [retval] out IProgress progress
10120 );
10121
10133 void exportTo (
10134 in IAppliance appliance,
10135 in wstring location,
10136 [retval] out IVirtualSystemDescription description
10137 );
10138
10162 void findSnapshot (
10163 in wstring nameOrId,
10164 [retval] out ISnapshot snapshot
10165 );
10166
10200 void createSharedFolder (
10201 in wstring name,
10202 in wstring hostPath,
10203 in boolean writable,
10204 in boolean automount
10205 );
10206
10232 void removeSharedFolder (
10233 in wstring name
10234 );
10235
10259 void canShowConsoleWindow (
10260 [retval] out boolean canShow
10261 );
10262
10297 void showConsoleWindow (
10298 [retval] out long long winId
10299 );
10300
10333 void getGuestProperty (
10334 in wstring name,
10335 out wstring value,
10336 out long long timestamp,
10337 out wstring flags
10338 );
10339
10362 void getGuestPropertyValue (
10363 in wstring property,
10364 [retval] out wstring value
10365 );
10366
10389 void getGuestPropertyTimestamp (
10390 in wstring property,
10391 [retval] out long long value
10392 );
10393
10444 void setGuestProperty (
10445 in wstring property,
10446 in wstring value,
10447 in wstring flags
10448 );
10449
10489 void setGuestPropertyValue (
10490 in wstring property,
10491 in wstring value
10492 );
10493
10511 void deleteGuestProperty (
10512 in wstring name
10513 );
10514
10545 void enumerateGuestProperties (
10546 in wstring patterns,
10547 out wstring[] names,
10548 out wstring[] values,
10549 out long long[] timestamps,
10550 out wstring[] flags
10551 );
10552
10582 void querySavedGuestScreenInfo (
10583 in unsigned long screenId,
10584 out unsigned long originX,
10585 out unsigned long originY,
10586 out unsigned long width,
10587 out unsigned long height,
10588 out boolean enabled
10589 );
10590
10612 void querySavedThumbnailSize (
10613 in unsigned long screenId,
10614 out unsigned long size,
10615 out unsigned long width,
10616 out unsigned long height
10617 );
10618
10645 void readSavedThumbnailToArray (
10646 in unsigned long screenId,
10647 in boolean BGR,
10648 out unsigned long width,
10649 out unsigned long height,
10650 [retval] out octet[] data
10651 );
10652
10674 void readSavedThumbnailPNGToArray (
10675 in unsigned long screenId,
10676 out unsigned long width,
10677 out unsigned long height,
10678 [retval] out octet[] data
10679 );
10680
10702 void querySavedScreenshotPNGSize (
10703 in unsigned long screenId,
10704 out unsigned long size,
10705 out unsigned long width,
10706 out unsigned long height
10707 );
10708
10730 void readSavedScreenshotPNGToArray (
10731 in unsigned long screenId,
10732 out unsigned long width,
10733 out unsigned long height,
10734 [retval] out octet[] data
10735 );
10736
10746 void hotPlugCPU (
10747 in unsigned long cpu
10748 );
10749
10759 void hotUnplugCPU (
10760 in unsigned long cpu
10761 );
10762
10776 void getCPUStatus (
10777 in unsigned long cpu,
10778 [retval] out boolean attached
10779 );
10780
10795 void queryLogFilename (
10796 in unsigned long idx,
10797 [retval] out wstring filename
10798 );
10799
10825 void readLog (
10826 in unsigned long idx,
10827 in long long offset,
10828 in long long size,
10829 [retval] out octet[] data
10830 );
10831
10864 void cloneTo (
10865 in IMachine target,
10866 in CloneMode mode,
10867 in CloneOptions[] options,
10868 [retval] out IProgress progress
10869 );
10870
10871 };
10872
10880 interface IEmulatedUSB : $unknown
10881 {
10885 readonly attribute wstring[] webcams;
10886
10896 void webcamAttach (
10897 in wstring path,
10898 in wstring settings
10899 );
10900
10908 void webcamDetach (
10909 in wstring path
10910 );
10911
10912 };
10913
10922 interface IVRDEServerInfo : $unknown
10923 {
10929 readonly attribute boolean active;
10930
10939 readonly attribute long port;
10940
10946 readonly attribute unsigned long numberOfClients;
10947
10953 readonly attribute long long beginTime;
10954
10961 readonly attribute long long endTime;
10962
10968 readonly attribute long long bytesSent;
10969
10975 readonly attribute long long bytesSentTotal;
10976
10982 readonly attribute long long bytesReceived;
10983
10989 readonly attribute long long bytesReceivedTotal;
10990
10996 readonly attribute wstring user;
10997
11003 readonly attribute wstring domain;
11004
11010 readonly attribute wstring clientName;
11011
11017 readonly attribute wstring clientIP;
11018
11024 readonly attribute unsigned long clientVersion;
11025
11033 readonly attribute unsigned long encryptionStyle;
11034
11035 };
11036
11058 interface IConsole : $unknown
11059 {
11071 readonly attribute IMachine machine;
11072
11086 readonly attribute MachineState state;
11087
11091 readonly attribute IGuest guest;
11092
11103 readonly attribute IKeyboard keyboard;
11104
11115 readonly attribute IMouse mouse;
11116
11126 readonly attribute IDisplay display;
11127
11131 readonly attribute IMachineDebugger debugger;
11132
11143 readonly attribute IUSBDevice[] USBDevices;
11144
11152 readonly attribute IHostUSBDevice[] remoteUSBDevices;
11153
11169 readonly attribute ISharedFolder[] sharedFolders;
11170
11176 readonly attribute IVRDEServerInfo VRDEServerInfo;
11177
11183 readonly attribute IEventSource eventSource;
11184
11188 readonly attribute IPCIDeviceAttachment[] attachedPCIDevices;
11189
11198 attribute boolean useHostClipboard;
11199
11205 readonly attribute IEmulatedUSB emulatedUSB;
11206
11271 void powerUp (
11272 [retval] out IProgress progress
11273 );
11274
11308 void powerUpPaused (
11309 [retval] out IProgress progress
11310 );
11311
11331 void powerDown (
11332 [retval] out IProgress progress
11333 );
11334
11354 void reset();
11355
11375 void pause();
11376
11396 void resume();
11397
11417 void powerButton();
11418
11438 void sleepButton();
11439
11451 void getPowerButtonHandled (
11452 [retval] out boolean handled
11453 );
11454
11468 void getGuestEnteredACPIMode (
11469 [retval] out boolean entered
11470 );
11471
11524 void saveState (
11525 [retval] out IProgress progress
11526 );
11527
11560 void adoptSavedState (
11561 in wstring savedStateFile
11562 );
11563
11594 void discardSavedState (
11595 in boolean fRemoveFile
11596 );
11597
11610 void getDeviceActivity (
11611 in DeviceType type,
11612 [retval] out DeviceActivity activity
11613 );
11614
11652 void attachUSBDevice (
11653 in wstringUUID id
11654 );
11655
11690 void detachUSBDevice (
11691 in wstringUUID id,
11692 [retval] out IUSBDevice device
11693 );
11694
11717 void findUSBDeviceByAddress (
11718 in wstring name,
11719 [retval] out IUSBDevice device
11720 );
11721
11741 void findUSBDeviceById (
11742 in wstringUUID id,
11743 [retval] out IUSBDevice device
11744 );
11745
11779 void createSharedFolder (
11780 in wstring name,
11781 in wstring hostPath,
11782 in boolean writable,
11783 in boolean automount
11784 );
11785
11810 void removeSharedFolder (
11811 in wstring name
11812 );
11813
11851 void takeSnapshot (
11852 in wstring name,
11853 in wstring description,
11854 [retval] out IProgress progress
11855 );
11856
11929 void deleteSnapshot (
11930 in wstringUUID id,
11931 [retval] out IProgress progress
11932 );
11933
11973 void deleteSnapshotAndAllChildren (
11974 in wstringUUID id,
11975 [retval] out IProgress progress
11976 );
11977
12021 void deleteSnapshotRange (
12022 in wstringUUID startId,
12023 in wstringUUID endId,
12024 [retval] out IProgress progress
12025 );
12026
12067 void restoreSnapshot (
12068 in ISnapshot snapshot,
12069 [retval] out IProgress progress
12070 );
12071
12110 void teleport (
12111 in wstring hostname,
12112 in unsigned long tcpport,
12113 in wstring password,
12114 in unsigned long maxDowntime,
12115 [retval] out IProgress progress
12116 );
12117
12118 };
12119
12130 interface IHostNetworkInterface : $unknown
12131 {
12135 readonly attribute wstring name;
12136
12140 readonly attribute wstring shortName;
12141
12145 readonly attribute wstringUUID id;
12146
12150 readonly attribute wstring networkName;
12151
12155 readonly attribute boolean DHCPEnabled;
12156
12160 readonly attribute wstring IPAddress;
12161
12165 readonly attribute wstring networkMask;
12166
12170 readonly attribute boolean IPV6Supported;
12171
12175 readonly attribute wstring IPV6Address;
12176
12180 readonly attribute unsigned long IPV6NetworkMaskPrefixLength;
12181
12185 readonly attribute wstring hardwareAddress;
12186
12190 readonly attribute HostNetworkInterfaceMediumType mediumType;
12191
12195 readonly attribute HostNetworkInterfaceStatus status;
12196
12200 readonly attribute HostNetworkInterfaceType interfaceType;
12201
12213 void enableStaticIPConfig (
12214 in wstring IPAddress,
12215 in wstring networkMask
12216 );
12217
12229 void enableStaticIPConfigV6 (
12230 in wstring IPV6Address,
12231 in unsigned long IPV6NetworkMaskPrefixLength
12232 );
12233
12237 void enableDynamicIPConfig();
12238
12242 void DHCPRediscover();
12243
12244 };
12245
12253 interface IHostVideoInputDevice : $unknown
12254 {
12258 readonly attribute wstring name;
12259
12263 readonly attribute wstring path;
12264
12268 readonly attribute wstring alias;
12269
12270 };
12271
12288 interface IHost : $unknown
12289 {
12293 readonly attribute IMedium[] DVDDrives;
12294
12298 readonly attribute IMedium[] floppyDrives;
12299
12313 readonly attribute IHostUSBDevice[] USBDevices;
12314
12338 readonly attribute IHostUSBDeviceFilter[] USBDeviceFilters;
12339
12343 readonly attribute IHostNetworkInterface[] networkInterfaces;
12344
12348 readonly attribute wstring[] nameServers;
12349
12353 readonly attribute wstring domainName;
12354
12358 readonly attribute wstring[] searchStrings;
12359
12363 readonly attribute unsigned long processorCount;
12364
12368 readonly attribute unsigned long processorOnlineCount;
12369
12373 readonly attribute unsigned long processorCoreCount;
12374
12378 readonly attribute unsigned long processorOnlineCoreCount;
12379
12383 readonly attribute unsigned long memorySize;
12384
12388 readonly attribute unsigned long memoryAvailable;
12389
12393 readonly attribute wstring operatingSystem;
12394
12398 readonly attribute wstring OSVersion;
12399
12403 readonly attribute long long UTCTime;
12404
12408 readonly attribute boolean acceleration3DAvailable;
12409
12413 readonly attribute IHostVideoInputDevice[] videoInputDevices;
12414
12429 void getProcessorSpeed (
12430 in unsigned long cpuId,
12431 [retval] out unsigned long speed
12432 );
12433
12445 void getProcessorFeature (
12446 in ProcessorFeature feature,
12447 [retval] out boolean supported
12448 );
12449
12468 void getProcessorDescription (
12469 in unsigned long cpuId,
12470 [retval] out wstring description
12471 );
12472
12513 void getProcessorCPUIDLeaf (
12514 in unsigned long cpuId,
12515 in unsigned long leaf,
12516 in unsigned long subLeaf,
12517 out unsigned long valEax,
12518 out unsigned long valEbx,
12519 out unsigned long valEcx,
12520 out unsigned long valEdx
12521 );
12522
12543 void createHostOnlyNetworkInterface (
12544 out IHostNetworkInterface hostInterface,
12545 [retval] out IProgress progress
12546 );
12547
12568 void removeHostOnlyNetworkInterface (
12569 in wstringUUID id,
12570 [retval] out IProgress progress
12571 );
12572
12592 void createUSBDeviceFilter (
12593 in wstring name,
12594 [retval] out IHostUSBDeviceFilter filter
12595 );
12596
12639 void insertUSBDeviceFilter (
12640 in unsigned long position,
12641 in IHostUSBDeviceFilter filter
12642 );
12643
12671 void removeUSBDeviceFilter (
12672 in unsigned long position
12673 );
12674
12692 void findHostDVDDrive (
12693 in wstring name,
12694 [retval] out IMedium drive
12695 );
12696
12714 void findHostFloppyDrive (
12715 in wstring name,
12716 [retval] out IMedium drive
12717 );
12718
12734 void findHostNetworkInterfaceByName (
12735 in wstring name,
12736 [retval] out IHostNetworkInterface networkInterface
12737 );
12738
12754 void findHostNetworkInterfaceById (
12755 in wstringUUID id,
12756 [retval] out IHostNetworkInterface networkInterface
12757 );
12758
12768 void findHostNetworkInterfacesOfType (
12769 in HostNetworkInterfaceType type,
12770 [retval] out IHostNetworkInterface[] networkInterfaces
12771 );
12772
12792 void findUSBDeviceById (
12793 in wstringUUID id,
12794 [retval] out IHostUSBDevice device
12795 );
12796
12819 void findUSBDeviceByAddress (
12820 in wstring name,
12821 [retval] out IHostUSBDevice device
12822 );
12823
12831 void generateMACAddress (
12832 [retval] out wstring address
12833 );
12834
12835 };
12836
12849 interface ISystemProperties : $unknown
12850 {
12854 readonly attribute unsigned long minGuestRAM;
12855
12859 readonly attribute unsigned long maxGuestRAM;
12860
12864 readonly attribute unsigned long minGuestVRAM;
12865
12869 readonly attribute unsigned long maxGuestVRAM;
12870
12874 readonly attribute unsigned long minGuestCPUCount;
12875
12879 readonly attribute unsigned long maxGuestCPUCount;
12880
12884 readonly attribute unsigned long maxGuestMonitors;
12885
12890 readonly attribute long long infoVDSize;
12891
12898 readonly attribute unsigned long serialPortCount;
12899
12906 readonly attribute unsigned long parallelPortCount;
12907
12917 readonly attribute unsigned long maxBootPosition;
12918
12927 attribute boolean exclusiveHwVirt;
12928
12952 attribute wstring defaultMachineFolder;
12953
12959 attribute wstring loggingLevel;
12960
12985 readonly attribute IMediumFormat[] mediumFormats;
12986
13020 attribute wstring defaultHardDiskFormat;
13021
13027 attribute long long freeDiskSpaceWarning;
13028
13033 attribute unsigned long freeDiskSpacePercentWarning;
13034
13040 attribute long long freeDiskSpaceError;
13041
13046 attribute unsigned long freeDiskSpacePercentError;
13047
13071 attribute wstring VRDEAuthLibrary;
13072
13101 attribute wstring webServiceAuthLibrary;
13102
13116 attribute wstring defaultVRDEExtPack;
13117
13123 attribute unsigned long logHistoryCount;
13124
13129 readonly attribute AudioDriverType defaultAudioDriver;
13130
13137 attribute wstring autostartDatabasePath;
13138
13145 attribute wstring defaultAdditionsISO;
13146
13161 attribute wstring defaultFrontend;
13162
13173 void getMaxNetworkAdapters (
13174 in ChipsetType chipset,
13175 [retval] out unsigned long maxNetworkAdapters
13176 );
13177
13191 void getMaxNetworkAdaptersOfType (
13192 in ChipsetType chipset,
13193 in NetworkAttachmentType type,
13194 [retval] out unsigned long maxNetworkAdapters
13195 );
13196
13206 void getMaxDevicesPerPortForStorageBus (
13207 in StorageBus bus,
13208 [retval] out unsigned long maxDevicesPerPort
13209 );
13210
13218 void getMinPortCountForStorageBus (
13219 in StorageBus bus,
13220 [retval] out unsigned long minPortCount
13221 );
13222
13230 void getMaxPortCountForStorageBus (
13231 in StorageBus bus,
13232 [retval] out unsigned long maxPortCount
13233 );
13234
13247 void getMaxInstancesOfStorageBus (
13248 in ChipsetType chipset,
13249 in StorageBus bus,
13250 [retval] out unsigned long maxInstances
13251 );
13252
13262 void getDeviceTypesForStorageBus (
13263 in StorageBus bus,
13264 [retval] out DeviceType[] deviceTypes
13265 );
13266
13275 void getDefaultIoCacheSettingForStorageController (
13276 in StorageControllerType controllerType,
13277 [retval] out boolean enabled
13278 );
13279
13292 void getMaxInstancesOfUSBControllerType (
13293 in ChipsetType chipset,
13294 in USBControllerType type,
13295 [retval] out unsigned long maxInstances
13296 );
13297
13298 };
13299
13305 interface IGuestOSType : $unknown
13306 {
13310 readonly attribute wstring familyId;
13311
13315 readonly attribute wstring familyDescription;
13316
13320 readonly attribute wstring id;
13321
13325 readonly attribute wstring description;
13326
13330 readonly attribute boolean is64Bit;
13331
13335 readonly attribute boolean recommendedIOAPIC;
13336
13340 readonly attribute boolean recommendedVirtEx;
13341
13345 readonly attribute unsigned long recommendedRAM;
13346
13350 readonly attribute unsigned long recommendedVRAM;
13351
13355 readonly attribute boolean recommended2DVideoAcceleration;
13356
13360 readonly attribute boolean recommended3DAcceleration;
13361
13365 readonly attribute long long recommendedHDD;
13366
13370 readonly attribute NetworkAdapterType adapterType;
13371
13375 readonly attribute boolean recommendedPAE;
13376
13380 readonly attribute StorageControllerType recommendedDVDStorageController;
13381
13385 readonly attribute StorageBus recommendedDVDStorageBus;
13386
13390 readonly attribute StorageControllerType recommendedHDStorageController;
13391
13395 readonly attribute StorageBus recommendedHDStorageBus;
13396
13400 readonly attribute FirmwareType recommendedFirmware;
13401
13405 readonly attribute boolean recommendedUSBHID;
13406
13410 readonly attribute boolean recommendedHPET;
13411
13415 readonly attribute boolean recommendedUSBTablet;
13416
13420 readonly attribute boolean recommendedRTCUseUTC;
13421
13425 readonly attribute ChipsetType recommendedChipset;
13426
13430 readonly attribute AudioControllerType recommendedAudioController;
13431
13435 readonly attribute boolean recommendedFloppy;
13436
13440 readonly attribute boolean recommendedUSB;
13441
13442 };
13443
13451 interface IAdditionsFacility : $unknown
13452 {
13456 readonly attribute AdditionsFacilityClass classType;
13457
13464 readonly attribute long long lastUpdated;
13465
13469 readonly attribute wstring name;
13470
13474 readonly attribute AdditionsFacilityStatus status;
13475
13479 readonly attribute AdditionsFacilityType type;
13480
13481 };
13482
13511 interface IGuestSession : $unknown
13512 {
13518 readonly attribute wstring user;
13519
13525 readonly attribute wstring domain;
13526
13530 readonly attribute wstring name;
13531
13535 readonly attribute unsigned long id;
13536
13549 attribute unsigned long timeout;
13550
13555 readonly attribute unsigned long protocolVersion;
13556
13560 readonly attribute GuestSessionStatus status;
13561
13567 attribute wstring[] environment;
13568
13574 readonly attribute IGuestProcess[] processes;
13575
13581 readonly attribute IGuestDirectory[] directories;
13582
13588 readonly attribute IGuestFile[] files;
13589
13595 readonly attribute IEventSource eventSource;
13596
13605 void close();
13606
13628 void copyFrom (
13629 in wstring source,
13630 in wstring dest,
13631 in CopyFileFlag[] flags,
13632 [retval] out IProgress progress
13633 );
13634
13656 void copyTo (
13657 in wstring source,
13658 in wstring dest,
13659 in CopyFileFlag[] flags,
13660 [retval] out IProgress progress
13661 );
13662
13682 void directoryCreate (
13683 in wstring path,
13684 in unsigned long mode,
13685 in DirectoryCreateFlag[] flags
13686 );
13687
13739 void directoryCreateTemp (
13740 in wstring templateName,
13741 in unsigned long mode,
13742 in wstring path,
13743 in boolean secure,
13744 [retval] out wstring directory
13745 );
13746
13764 void directoryExists (
13765 in wstring path,
13766 [retval] out boolean exists
13767 );
13768
13799 void directoryOpen (
13800 in wstring path,
13801 in wstring filter,
13802 in DirectoryOpenFlag[] flags,
13803 [retval] out IGuestDirectory directory
13804 );
13805
13831 void directoryQueryInfo (
13832 in wstring path,
13833 [retval] out IGuestFsObjInfo info
13834 );
13835
13843 void directoryRemove (
13844 in wstring path
13845 );
13846
13859 void directoryRemoveRecursive (
13860 in wstring path,
13861 in DirectoryRemoveRecFlag[] flags,
13862 [retval] out IProgress progress
13863 );
13864
13876 void directoryRename (
13877 in wstring source,
13878 in wstring dest,
13879 in PathRenameFlag[] flags
13880 );
13881
13899 void directorySetACL (
13900 in wstring path,
13901 in wstring acl
13902 );
13903
13917 void environmentClear();
13918
13939 void environmentGet (
13940 in wstring name,
13941 [retval] out wstring value
13942 );
13943
13961 void environmentSet (
13962 in wstring name,
13963 in wstring value
13964 );
13965
13981 void environmentUnset (
13982 in wstring name
13983 );
13984
14038 void fileCreateTemp (
14039 in wstring templateName,
14040 in unsigned long mode,
14041 in wstring path,
14042 in boolean secure,
14043 [retval] out IGuestFile file
14044 );
14045
14063 void fileExists (
14064 in wstring path,
14065 [retval] out boolean exists
14066 );
14067
14091 void fileRemove (
14092 in wstring path
14093 );
14094
14156 void fileOpen (
14157 in wstring path,
14158 in wstring openMode,
14159 in wstring disposition,
14160 in unsigned long creationMode,
14161 [retval] out IGuestFile file
14162 );
14163
14230 void fileOpenEx (
14231 in wstring path,
14232 in wstring openMode,
14233 in wstring disposition,
14234 in wstring sharingMode,
14235 in unsigned long creationMode,
14236 in long long offset,
14237 [retval] out IGuestFile file
14238 );
14239
14265 void fileQueryInfo (
14266 in wstring path,
14267 [retval] out IGuestFsObjInfo info
14268 );
14269
14295 void fileQuerySize (
14296 in wstring path,
14297 [retval] out long long size
14298 );
14299
14311 void fileRename (
14312 in wstring source,
14313 in wstring dest,
14314 in PathRenameFlag[] flags
14315 );
14316
14334 void fileSetACL (
14335 in wstring file,
14336 in wstring acl
14337 );
14338
14393 void processCreate (
14394 in wstring command,
14395 in wstring[] arguments,
14396 in wstring[] environment,
14397 in ProcessCreateFlag[] flags,
14398 in unsigned long timeoutMS,
14399 [retval] out IGuestProcess guestProcess
14400 );
14401
14443 void processCreateEx (
14444 in wstring command,
14445 in wstring[] arguments,
14446 in wstring[] environment,
14447 in ProcessCreateFlag[] flags,
14448 in unsigned long timeoutMS,
14449 in ProcessPriority priority,
14450 in long[] affinity,
14451 [retval] out IGuestProcess guestProcess
14452 );
14453
14463 void processGet (
14464 in unsigned long pid,
14465 [retval] out IGuestProcess guestProcess
14466 );
14467
14490 void symlinkCreate (
14491 in wstring source,
14492 in wstring target,
14493 in SymlinkType type
14494 );
14495
14513 void symlinkExists (
14514 in wstring symlink,
14515 [retval] out boolean exists
14516 );
14517
14541 void symlinkRead (
14542 in wstring symlink,
14543 in SymlinkReadFlag[] flags,
14544 [retval] out wstring target
14545 );
14546
14562 void symlinkRemoveDirectory (
14563 in wstring path
14564 );
14565
14581 void symlinkRemoveFile (
14582 in wstring file
14583 );
14584
14605 void waitFor (
14606 in unsigned long waitFor,
14607 in unsigned long timeoutMS,
14608 [retval] out GuestSessionWaitResult reason
14609 );
14610
14632 void waitForArray (
14633 in GuestSessionWaitForFlag[] waitFor,
14634 in unsigned long timeoutMS,
14635 [retval] out GuestSessionWaitResult reason
14636 );
14637
14638 };
14639
14647 interface IProcess : $unknown
14648 {
14654 readonly attribute wstring[] arguments;
14655
14661 readonly attribute wstring[] environment;
14662
14668 readonly attribute IEventSource eventSource;
14669
14673 readonly attribute wstring executablePath;
14674
14681 readonly attribute long exitCode;
14682
14688 readonly attribute wstring name;
14689
14695 readonly attribute unsigned long PID;
14696
14703 readonly attribute ProcessStatus status;
14704
14725 void waitFor (
14726 in unsigned long waitFor,
14727 in unsigned long timeoutMS,
14728 [retval] out ProcessWaitResult reason
14729 );
14730
14752 void waitForArray (
14753 in ProcessWaitForFlag[] waitFor,
14754 in unsigned long timeoutMS,
14755 [retval] out ProcessWaitResult reason
14756 );
14757
14774 void read (
14775 in unsigned long handle,
14776 in unsigned long toRead,
14777 in unsigned long timeoutMS,
14778 [retval] out octet[] data
14779 );
14780
14804 void write (
14805 in unsigned long handle,
14806 in unsigned long flags,
14807 in octet[] data,
14808 in unsigned long timeoutMS,
14809 [retval] out unsigned long written
14810 );
14811
14836 void writeArray (
14837 in unsigned long handle,
14838 in ProcessInputFlag[] flags,
14839 in octet[] data,
14840 in unsigned long timeoutMS,
14841 [retval] out unsigned long written
14842 );
14843
14853 void terminate();
14854
14855 };
14856
14865 interface IGuestProcess : IProcess
14866 {
14867 };
14868
14876 interface IDirectory : $unknown
14877 {
14883 readonly attribute wstring directoryName;
14884
14890 readonly attribute wstring filter;
14891
14898 void close();
14899
14915 void read (
14916 [retval] out IFsObjInfo objInfo
14917 );
14918
14919 };
14920
14929 interface IGuestDirectory : IDirectory
14930 {
14931 };
14932
14940 interface IFile : $unknown
14941 {
14947 readonly attribute unsigned long creationMode;
14948
14954 readonly attribute wstring disposition;
14955
14961 readonly attribute IEventSource eventSource;
14962
14968 readonly attribute wstring fileName;
14969
14975 readonly attribute unsigned long id;
14976
14982 readonly attribute long long initialSize;
14983
14989 readonly attribute wstring openMode;
14990
14996 readonly attribute long long offset;
14997
15003 readonly attribute FileStatus status;
15004
15011 void close();
15012
15029 void queryInfo (
15030 [retval] out IFsObjInfo objInfo
15031 );
15032
15055 void read (
15056 in unsigned long toRead,
15057 in unsigned long timeoutMS,
15058 [retval] out octet[] data
15059 );
15060
15085 void readAt (
15086 in long long offset,
15087 in unsigned long toRead,
15088 in unsigned long timeoutMS,
15089 [retval] out octet[] data
15090 );
15091
15111 void seek (
15112 in long long offset,
15113 in FileSeekType whence
15114 );
15115
15131 void setACL (
15132 in wstring acl
15133 );
15134
15152 void write (
15153 in octet[] data,
15154 in unsigned long timeoutMS,
15155 [retval] out unsigned long written
15156 );
15157
15185 void writeAt (
15186 in long long offset,
15187 in octet[] data,
15188 in unsigned long timeoutMS,
15189 [retval] out unsigned long written
15190 );
15191
15192 };
15193
15202 interface IGuestFile : IFile
15203 {
15204 };
15205
15214 interface IFsObjInfo : $unknown
15215 {
15221 readonly attribute long long accessTime;
15222
15228 readonly attribute long long allocatedSize;
15229
15235 readonly attribute long long birthTime;
15236
15242 readonly attribute long long changeTime;
15243
15249 readonly attribute unsigned long deviceNumber;
15250
15256 readonly attribute wstring fileAttributes;
15257
15263 readonly attribute unsigned long generationId;
15264
15270 readonly attribute unsigned long GID;
15271
15277 readonly attribute wstring groupName;
15278
15284 readonly attribute unsigned long hardLinks;
15285
15291 readonly attribute long long modificationTime;
15292
15298 readonly attribute wstring name;
15299
15305 readonly attribute long long nodeId;
15306
15312 readonly attribute unsigned long nodeIdDevice;
15313
15321 readonly attribute long long objectSize;
15322
15328 readonly attribute FsObjType type;
15329
15335 readonly attribute unsigned long UID;
15336
15342 readonly attribute unsigned long userFlags;
15343
15349 readonly attribute wstring userName;
15350
15351 };
15352
15361 interface IGuestFsObjInfo : IFsObjInfo
15362 {
15363 };
15364
15378 interface IGuest : $unknown
15379 {
15394 readonly attribute wstring OSTypeId;
15395
15401 readonly attribute AdditionsRunLevelType additionsRunLevel;
15402
15409 readonly attribute wstring additionsVersion;
15410
15418 readonly attribute unsigned long additionsRevision;
15419
15425 readonly attribute IEventSource eventSource;
15426
15433 readonly attribute IAdditionsFacility[] facilities;
15434
15438 readonly attribute IGuestSession[] sessions;
15439
15443 attribute unsigned long memoryBalloonSize;
15444
15448 attribute unsigned long statisticsUpdateInterval;
15449
15481 void internalGetStatistics (
15482 out unsigned long cpuUser,
15483 out unsigned long cpuKernel,
15484 out unsigned long cpuIdle,
15485 out unsigned long memTotal,
15486 out unsigned long memFree,
15487 out unsigned long memBalloon,
15488 out unsigned long memShared,
15489 out unsigned long memCache,
15490 out unsigned long pagedTotal,
15491 out unsigned long memAllocTotal,
15492 out unsigned long memFreeTotal,
15493 out unsigned long memBalloonTotal,
15494 out unsigned long memSharedTotal
15495 );
15496
15508 void getFacilityStatus (
15509 in AdditionsFacilityType facility,
15510 out long long timestamp,
15511 [retval] out AdditionsFacilityStatus status
15512 );
15513
15531 void getAdditionsStatus (
15532 in AdditionsRunLevelType level,
15533 [retval] out boolean active
15534 );
15535
15565 void setCredentials (
15566 in wstring userName,
15567 in wstring password,
15568 in wstring domain,
15569 in boolean allowInteractiveLogon
15570 );
15571
15601 void dragHGEnter (
15602 in unsigned long screenId,
15603 in unsigned long y,
15604 in unsigned long x,
15605 in DragAndDropAction defaultAction,
15606 in DragAndDropAction[] allowedActions,
15607 in wstring[] formats,
15608 [retval] out DragAndDropAction resultAction
15609 );
15610
15640 void dragHGMove (
15641 in unsigned long screenId,
15642 in unsigned long x,
15643 in unsigned long y,
15644 in DragAndDropAction defaultAction,
15645 in DragAndDropAction[] allowedActions,
15646 in wstring[] formats,
15647 [retval] out DragAndDropAction resultAction
15648 );
15649
15667 void dragHGLeave (
15668 in unsigned long screenId
15669 );
15670
15702 void dragHGDrop (
15703 in unsigned long screenId,
15704 in unsigned long x,
15705 in unsigned long y,
15706 in DragAndDropAction defaultAction,
15707 in DragAndDropAction[] allowedActions,
15708 in wstring[] formats,
15709 out wstring format,
15710 [retval] out DragAndDropAction resultAction
15711 );
15712
15736 void dragHGPutData (
15737 in unsigned long screenId,
15738 in wstring format,
15739 in octet[] data,
15740 [retval] out IProgress progress
15741 );
15742
15768 void dragGHPending (
15769 in unsigned long screenId,
15770 out wstring[] formats,
15771 out DragAndDropAction[] allowedActions,
15772 [retval] out DragAndDropAction defaultAction
15773 );
15774
15796 void dragGHDropped (
15797 in wstring format,
15798 in DragAndDropAction action,
15799 [retval] out IProgress progress
15800 );
15801
15819 void dragGHGetData (
15820 [retval] out octet[] data
15821 );
15822
15885 void createSession (
15886 in wstring user,
15887 in wstring password,
15888 in wstring domain,
15889 in wstring sessionName,
15890 [retval] out IGuestSession guestSession
15891 );
15892
15907 void findSession (
15908 in wstring sessionName,
15909 [retval] out IGuestSession[] sessions
15910 );
15911
15961 void updateGuestAdditions (
15962 in wstring source,
15963 in wstring[] arguments,
15964 in AdditionsUpdateFlag[] flags,
15965 [retval] out IProgress progress
15966 );
15967
15968 };
15969
16010 interface IProgress : $unknown
16011 {
16015 readonly attribute wstringUUID id;
16016
16020 readonly attribute wstring description;
16021
16025 readonly attribute $unknown initiator;
16026
16030 readonly attribute boolean cancelable;
16031
16039 readonly attribute unsigned long percent;
16040
16054 readonly attribute long timeRemaining;
16055
16059 readonly attribute boolean completed;
16060
16064 readonly attribute boolean canceled;
16065
16072 readonly attribute long resultCode;
16073
16083 readonly attribute IVirtualBoxErrorInfo errorInfo;
16084
16091 readonly attribute unsigned long operationCount;
16092
16096 readonly attribute unsigned long operation;
16097
16103 readonly attribute wstring operationDescription;
16104
16108 readonly attribute unsigned long operationPercent;
16109
16113 readonly attribute unsigned long operationWeight;
16114
16122 attribute unsigned long timeout;
16123
16127 void setCurrentOperationProgress (
16128 in unsigned long percent
16129 );
16130
16134 void setNextOperation (
16135 in wstring nextOperationDescription,
16136 in unsigned long nextOperationsWeight
16137 );
16138
16165 void waitForCompletion (
16166 in long timeout
16167 );
16168
16192 void waitForOperationCompletion (
16193 in unsigned long operation,
16194 in long timeout
16195 );
16196
16222 void waitForAsyncProgressCompletion (
16223 in IProgress pProgressAsync
16224 );
16225
16242 void cancel();
16243
16244 };
16245
16329 interface ISnapshot : $unknown
16330 {
16334 readonly attribute wstringUUID id;
16335
16343 attribute wstring name;
16344
16352 attribute wstring description;
16353
16359 readonly attribute long long timeStamp;
16360
16372 readonly attribute boolean online;
16373
16385 readonly attribute IMachine machine;
16386
16393 readonly attribute ISnapshot parent;
16394
16403 readonly attribute ISnapshot[] children;
16404
16412 void getChildrenCount (
16413 [retval] out unsigned long childrenCount
16414 );
16415
16416 };
16417
16604 interface IMediumAttachment : $unknown
16605 {
16610 readonly attribute IMedium medium;
16611
16617 readonly attribute wstring controller;
16618
16624 readonly attribute long port;
16625
16631 readonly attribute long device;
16632
16636 readonly attribute DeviceType type;
16637
16641 readonly attribute boolean passthrough;
16642
16646 readonly attribute boolean temporaryEject;
16647
16652 readonly attribute boolean isEjected;
16653
16657 readonly attribute boolean nonRotational;
16658
16662 readonly attribute boolean discard;
16663
16667 readonly attribute boolean hotPluggable;
16668
16672 readonly attribute IBandwidthGroup bandwidthGroup;
16673
16674 };
16675
16833 interface IMedium : $unknown
16834 {
16848 readonly attribute wstringUUID id;
16849
16868 attribute wstring description;
16869
16885 readonly attribute MediumState state;
16886
16895 readonly attribute MediumVariant[] variant;
16896
16906 readonly attribute wstring location;
16907
16927 readonly attribute wstring name;
16928
16933 readonly attribute DeviceType deviceType;
16934
16938 readonly attribute boolean hostDrive;
16939
16952 readonly attribute long long size;
16953
16968 readonly attribute wstring format;
16969
16985 readonly attribute IMediumFormat mediumFormat;
16986
17011 attribute MediumType type;
17012
17026 readonly attribute MediumType[] allowedTypes;
17027
17037 readonly attribute IMedium parent;
17038
17046 readonly attribute IMedium[] children;
17047
17058 readonly attribute IMedium base;
17059
17092 readonly attribute boolean readOnly;
17093
17109 readonly attribute long long logicalSize;
17110
17138 attribute boolean autoReset;
17139
17154 readonly attribute wstring lastAccessError;
17155
17172 readonly attribute wstringUUID[] machineIds;
17173
17199 void setIds (
17200 in boolean setImageId,
17201 in wstringUUID imageId,
17202 in boolean setParentId,
17203 in wstringUUID parentId
17204 );
17205
17240 void refreshState (
17241 [retval] out MediumState state
17242 );
17243
17270 void getSnapshotIds (
17271 in wstringUUID machineId,
17272 [retval] out wstringUUID[] snapshotIds
17273 );
17274
17337 void lockRead (
17338 [retval] out IToken token
17339 );
17340
17395 void lockWrite (
17396 [retval] out IToken token
17397 );
17398
17448 void close();
17449
17479 void getProperty (
17480 in wstring name,
17481 [retval] out wstring value
17482 );
17483
17515 void setProperty (
17516 in wstring name,
17517 in wstring value
17518 );
17519
17554 void getProperties (
17555 in wstring names,
17556 out wstring[] returnNames,
17557 [retval] out wstring[] returnValues
17558 );
17559
17589 void setProperties (
17590 in wstring[] names,
17591 in wstring[] values
17592 );
17593
17626 void createBaseStorage (
17627 in long long logicalSize,
17628 in MediumVariant[] variant,
17629 [retval] out IProgress progress
17630 );
17631
17683 void deleteStorage (
17684 [retval] out IProgress progress
17685 );
17686
17725 void createDiffStorage (
17726 in IMedium target,
17727 in MediumVariant[] variant,
17728 [retval] out IProgress progress
17729 );
17730
17806 void mergeTo (
17807 in IMedium target,
17808 [retval] out IProgress progress
17809 );
17810
17860 void cloneTo (
17861 in IMedium target,
17862 in MediumVariant[] variant,
17863 in IMedium parent,
17864 [retval] out IProgress progress
17865 );
17866
17913 void cloneToBase (
17914 in IMedium target,
17915 in MediumVariant[] variant,
17916 [retval] out IProgress progress
17917 );
17918
17960 void setLocation (
17961 in wstring location,
17962 [retval] out IProgress progress
17963 );
17964
17993 void compact (
17994 [retval] out IProgress progress
17995 );
17996
18029 void resize (
18030 in long long logicalSize,
18031 [retval] out IProgress progress
18032 );
18033
18067 void reset (
18068 [retval] out IProgress progress
18069 );
18070
18071 };
18072
18095 interface IMediumFormat : $unknown
18096 {
18115 readonly attribute wstring id;
18116
18124 readonly attribute wstring name;
18125
18134 readonly attribute MediumFormatCapabilities[] capabilities;
18135
18154 void describeFileExtensions (
18155 out wstring[] extensions,
18156 out DeviceType[] types
18157 );
18158
18186 void describeProperties (
18187 out wstring[] names,
18188 out wstring[] descriptions,
18189 out DataType[] types,
18190 out unsigned long[] flags,
18191 out wstring[] defaults
18192 );
18193
18194 };
18195
18210 interface IToken : $unknown
18211 {
18220 void abandon();
18221
18228 void dummy();
18229
18230 };
18231
18243 interface IKeyboard : $unknown
18244 {
18250 readonly attribute IEventSource eventSource;
18251
18264 void putScancode (
18265 in long scancode
18266 );
18267
18280 void putScancodes (
18281 in long[] scancodes,
18282 [retval] out unsigned long codesStored
18283 );
18284
18299 void putCAD();
18300
18301 };
18302
18314 interface IMouse : $unknown
18315 {
18330 readonly attribute boolean absoluteSupported;
18331
18346 readonly attribute boolean relativeSupported;
18347
18361 readonly attribute boolean multiTouchSupported;
18362
18377 readonly attribute boolean needsHostCursor;
18378
18384 readonly attribute IEventSource eventSource;
18385
18451 void putMouseEvent (
18452 in long dx,
18453 in long dy,
18454 in long dz,
18455 in long dw,
18456 in long buttonState
18457 );
18458
18531 void putMouseEventAbsolute (
18532 in long x,
18533 in long y,
18534 in long dz,
18535 in long dw,
18536 in long buttonState
18537 );
18538
18586 void putEventMultiTouch (
18587 in long count,
18588 in long long[] contacts,
18589 in unsigned long scanTime
18590 );
18591
18607 void putEventMultiTouchString (
18608 in long count,
18609 in wstring contacts,
18610 in unsigned long scanTime
18611 );
18612
18613 };
18614
18615 interface IFramebuffer : $unknown
18616 {
18625 readonly attribute octetPtr address;
18626
18630 readonly attribute unsigned long width;
18631
18635 readonly attribute unsigned long height;
18636
18643 readonly attribute unsigned long bitsPerPixel;
18644
18651 readonly attribute unsigned long bytesPerLine;
18652
18663 readonly attribute unsigned long pixelFormat;
18664
18671 readonly attribute boolean usesGuestVRAM;
18672
18682 readonly attribute unsigned long heightReduction;
18683
18698 readonly attribute IFramebufferOverlay overlay;
18699
18706 readonly attribute long long winId;
18707
18715 void lock();
18716
18724 void unlock();
18725
18733 void notifyUpdate (
18734 in unsigned long x,
18735 in unsigned long y,
18736 in unsigned long width,
18737 in unsigned long height
18738 );
18739
18852 void requestResize (
18853 in unsigned long screenId,
18854 in unsigned long pixelFormat,
18855 in octetPtr VRAM,
18856 in unsigned long bitsPerPixel,
18857 in unsigned long bytesPerLine,
18858 in unsigned long width,
18859 in unsigned long height,
18860 [retval] out boolean finished
18861 );
18862
18874 void videoModeSupported (
18875 in unsigned long width,
18876 in unsigned long height,
18877 in unsigned long bpp,
18878 [retval] out boolean supported
18879 );
18880
18917 void getVisibleRegion (
18918 in octetPtr rectangles,
18919 in unsigned long count,
18920 [retval] out unsigned long countCopied
18921 );
18922
18957 void setVisibleRegion (
18958 in octetPtr rectangles,
18959 in unsigned long count
18960 );
18961
18982 void processVHWACommand (
18983 in octetPtr command
18984 );
18985
19000 void notify3DEvent (
19001 in unsigned long type,
19002 in octetPtr data
19003 );
19004
19005 };
19006
19021 interface IFramebufferOverlay : IFramebuffer
19022 {
19026 readonly attribute unsigned long x;
19027
19031 readonly attribute unsigned long y;
19032
19038 attribute boolean visible;
19039
19046 attribute unsigned long alpha;
19047
19053 void move (
19054 in unsigned long x,
19055 in unsigned long y
19056 );
19057
19058 };
19059
19075 interface IDisplay : $unknown
19076 {
19080 void getScreenResolution (
19081 in unsigned long screenId,
19082 out unsigned long width,
19083 out unsigned long height,
19084 out unsigned long bitsPerPixel,
19085 out long xOrigin,
19086 out long yOrigin
19087 );
19088
19094 void setFramebuffer (
19095 in unsigned long screenId,
19096 in IFramebuffer framebuffer
19097 );
19098
19104 void getFramebuffer (
19105 in unsigned long screenId,
19106 out IFramebuffer framebuffer,
19107 out long xOrigin,
19108 out long yOrigin
19109 );
19110
19161 void setVideoModeHint (
19162 in unsigned long display,
19163 in boolean enabled,
19164 in boolean changeOrigin,
19165 in long originX,
19166 in long originY,
19167 in unsigned long width,
19168 in unsigned long height,
19169 in unsigned long bitsPerPixel
19170 );
19171
19183 void setSeamlessMode (
19184 in boolean enabled
19185 );
19186
19222 void takeScreenShot (
19223 in unsigned long screenId,
19224 in octetPtr address,
19225 in unsigned long width,
19226 in unsigned long height
19227 );
19228
19272 void takeScreenShotToArray (
19273 in unsigned long screenId,
19274 in unsigned long width,
19275 in unsigned long height,
19276 [retval] out octet[] screenData
19277 );
19278
19317 void takeScreenShotPNGToArray (
19318 in unsigned long screenId,
19319 in unsigned long width,
19320 in unsigned long height,
19321 [retval] out octet[] screenData
19322 );
19323
19375 void drawToScreen (
19376 in unsigned long screenId,
19377 in octetPtr address,
19378 in unsigned long x,
19379 in unsigned long y,
19380 in unsigned long width,
19381 in unsigned long height
19382 );
19383
19398 void invalidateAndUpdate();
19399
19413 void resizeCompleted (
19414 in unsigned long screenId
19415 );
19416
19429 void completeVHWACommand (
19430 in octetPtr command
19431 );
19432
19466 void viewportChanged (
19467 in unsigned long screenId,
19468 in unsigned long x,
19469 in unsigned long y,
19470 in unsigned long width,
19471 in unsigned long height
19472 );
19473
19474 };
19475
19491 interface INetworkAdapter : $unknown
19492 {
19500 attribute NetworkAdapterType adapterType;
19501
19509 readonly attribute unsigned long slot;
19510
19519 attribute boolean enabled;
19520
19527 attribute wstring MACAddress;
19528
19534 attribute NetworkAttachmentType attachmentType;
19535
19541 attribute wstring bridgedInterface;
19542
19548 attribute wstring hostOnlyInterface;
19549
19555 attribute wstring internalNetwork;
19556
19562 attribute wstring NATNetwork;
19563
19569 attribute wstring genericDriver;
19570
19577 attribute boolean cableConnected;
19578
19584 attribute unsigned long lineSpeed;
19585
19592 attribute NetworkAdapterPromiscModePolicy promiscModePolicy;
19593
19600 attribute boolean traceEnabled;
19601
19608 attribute wstring traceFile;
19609
19617 readonly attribute INATEngine NATEngine;
19618
19625 attribute unsigned long bootPriority;
19626
19630 attribute IBandwidthGroup bandwidthGroup;
19631
19650 void getProperty (
19651 in wstring key,
19652 [retval] out wstring value
19653 );
19654
19673 void setProperty (
19674 in wstring key,
19675 in wstring value
19676 );
19677
19705 void getProperties (
19706 in wstring names,
19707 out wstring[] returnNames,
19708 [retval] out wstring[] returnValues
19709 );
19710
19711 };
19712
19741 interface ISerialPort : $unknown
19742 {
19750 readonly attribute unsigned long slot;
19751
19758 attribute boolean enabled;
19759
19763 attribute unsigned long IOBase;
19764
19768 attribute unsigned long IRQ;
19769
19780 attribute PortMode hostMode;
19781
19789 attribute boolean server;
19790
19800 attribute wstring path;
19801
19802 };
19803
19823 interface IParallelPort : $unknown
19824 {
19832 readonly attribute unsigned long slot;
19833
19840 attribute boolean enabled;
19841
19845 attribute unsigned long IOBase;
19846
19850 attribute unsigned long IRQ;
19851
19859 attribute wstring path;
19860
19861 };
19862
19863 interface IMachineDebugger : $unknown
19864 {
19868 attribute boolean singleStep;
19869
19873 attribute boolean recompileUser;
19874
19878 attribute boolean recompileSupervisor;
19879
19887 attribute boolean executeAllInIEM;
19888
19892 attribute boolean PATMEnabled;
19893
19897 attribute boolean CSAMEnabled;
19898
19902 attribute boolean logEnabled;
19903
19907 readonly attribute wstring logDbgFlags;
19908
19912 readonly attribute wstring logDbgGroups;
19913
19917 readonly attribute wstring logDbgDestinations;
19918
19922 readonly attribute wstring logRelFlags;
19923
19927 readonly attribute wstring logRelGroups;
19928
19932 readonly attribute wstring logRelDestinations;
19933
19940 readonly attribute boolean HWVirtExEnabled;
19941
19948 readonly attribute boolean HWVirtExNestedPagingEnabled;
19949
19956 readonly attribute boolean HWVirtExVPIDEnabled;
19957
19964 readonly attribute boolean HWVirtExUXEnabled;
19965
19974 readonly attribute wstring OSName;
19975
19984 readonly attribute wstring OSVersion;
19985
19992 readonly attribute boolean PAEEnabled;
19993
20000 attribute unsigned long virtualTimeRate;
20001
20009 readonly attribute long long VM;
20010
20026 void dumpGuestCore (
20027 in wstring filename,
20028 in wstring compression
20029 );
20030
20047 void dumpHostProcessCore (
20048 in wstring filename,
20049 in wstring compression
20050 );
20051
20072 void info (
20073 in wstring name,
20074 in wstring args,
20075 [retval] out wstring info
20076 );
20077
20083 void injectNMI();
20084
20095 void modifyLogGroups (
20096 in wstring settings
20097 );
20098
20109 void modifyLogFlags (
20110 in wstring settings
20111 );
20112
20123 void modifyLogDestinations (
20124 in wstring settings
20125 );
20126
20141 void readPhysicalMemory (
20142 in long long address,
20143 in unsigned long size,
20144 [retval] out octet[] bytes
20145 );
20146
20161 void writePhysicalMemory (
20162 in long long address,
20163 in unsigned long size,
20164 in octet[] bytes
20165 );
20166
20183 void readVirtualMemory (
20184 in unsigned long cpuId,
20185 in long long address,
20186 in unsigned long size,
20187 [retval] out octet[] bytes
20188 );
20189
20206 void writeVirtualMemory (
20207 in unsigned long cpuId,
20208 in long long address,
20209 in unsigned long size,
20210 in octet[] bytes
20211 );
20212
20225 void detectOS (
20226 [retval] out wstring os
20227 );
20228
20246 void getRegister (
20247 in unsigned long cpuId,
20248 in wstring name,
20249 [retval] out wstring value
20250 );
20251
20269 void getRegisters (
20270 in unsigned long cpuId,
20271 out wstring[] names,
20272 out wstring[] values
20273 );
20274
20293 void setRegister (
20294 in unsigned long cpuId,
20295 in wstring name,
20296 in wstring value
20297 );
20298
20317 void setRegisters (
20318 in unsigned long cpuId,
20319 in wstring[] names,
20320 in wstring[] values
20321 );
20322
20335 void dumpGuestStack (
20336 in unsigned long cpuId,
20337 [retval] out wstring stack
20338 );
20339
20347 void resetStats (
20348 in wstring pattern
20349 );
20350
20358 void dumpStats (
20359 in wstring pattern
20360 );
20361
20373 void getStats (
20374 in wstring pattern,
20375 in boolean withDescriptions,
20376 [retval] out wstring stats
20377 );
20378
20379 };
20380
20381 interface IUSBDeviceFilters : $unknown
20382 {
20408 readonly attribute IUSBDeviceFilter[] deviceFilters;
20409
20437 void createDeviceFilter (
20438 in wstring name,
20439 [retval] out IUSBDeviceFilter filter
20440 );
20441
20486 void insertDeviceFilter (
20487 in unsigned long position,
20488 in IUSBDeviceFilter filter
20489 );
20490
20523 void removeDeviceFilter (
20524 in unsigned long position,
20525 [retval] out IUSBDeviceFilter filter
20526 );
20527
20528 };
20529
20530 interface IUSBController : $unknown
20531 {
20537 readonly attribute wstring name;
20538
20544 readonly attribute USBControllerType type;
20545
20553 readonly attribute unsigned short USBStandard;
20554
20555 };
20556
20569 interface IUSBDevice : $unknown
20570 {
20577 readonly attribute wstringUUID id;
20578
20582 readonly attribute unsigned short vendorId;
20583
20587 readonly attribute unsigned short productId;
20588
20596 readonly attribute unsigned short revision;
20597
20601 readonly attribute wstring manufacturer;
20602
20606 readonly attribute wstring product;
20607
20611 readonly attribute wstring serialNumber;
20612
20616 readonly attribute wstring address;
20617
20624 readonly attribute unsigned short port;
20625
20631 readonly attribute unsigned short version;
20632
20640 readonly attribute unsigned short portVersion;
20641
20648 readonly attribute boolean remote;
20649
20650 };
20651
20726 interface IUSBDeviceFilter : $unknown
20727 {
20735 attribute wstring name;
20736
20740 attribute boolean active;
20741
20749 attribute wstring vendorId;
20750
20758 attribute wstring productId;
20759
20773 attribute wstring revision;
20774
20779 attribute wstring manufacturer;
20780
20785 attribute wstring product;
20786
20791 attribute wstring serialNumber;
20792
20797 attribute wstring port;
20798
20808 attribute wstring remote;
20809
20819 attribute unsigned long maskedInterfaces;
20820
20821 };
20822
20839 interface IHostUSBDevice : IUSBDevice
20840 {
20846 readonly attribute USBDeviceState state;
20847
20848 };
20849
20872 interface IHostUSBDeviceFilter : IUSBDeviceFilter
20873 {
20880 attribute USBDeviceFilterAction action;
20881
20882 };
20883
20892 interface IAudioAdapter : $unknown
20893 {
20902 attribute boolean enabled;
20903
20909 attribute AudioControllerType audioController;
20910
20917 attribute AudioDriverType audioDriver;
20918
20919 };
20920
20921 interface IVRDEServer : $unknown
20922 {
20926 attribute boolean enabled;
20927
20931 attribute AuthType authType;
20932
20936 attribute unsigned long authTimeout;
20937
20944 attribute boolean allowMultiConnection;
20945
20953 attribute boolean reuseSingleConnection;
20954
20961 attribute wstring VRDEExtPack;
20962
20969 attribute wstring authLibrary;
20970
20976 readonly attribute wstring[] VRDEProperties;
20977
20991 void setVRDEProperty (
20992 in wstring key,
20993 in wstring value
20994 );
20995
21009 void getVRDEProperty (
21010 in wstring key,
21011 [retval] out wstring value
21012 );
21013
21014 };
21015
21073 interface ISharedFolder : $unknown
21074 {
21078 readonly attribute wstring name;
21079
21083 readonly attribute wstring hostPath;
21084
21094 readonly attribute boolean accessible;
21095
21102 readonly attribute boolean writable;
21103
21109 readonly attribute boolean autoMount;
21110
21123 readonly attribute wstring lastAccessError;
21124
21125 };
21126
21127 interface IInternalSessionControl : $unknown
21128 {
21133 void getPID (
21134 [retval] out unsigned long pid
21135 );
21136
21158 void getRemoteConsole (
21159 [retval] out IConsole console
21160 );
21161
21176 void assignRemoteMachine (
21177 in IMachine machine,
21178 in IConsole console
21179 );
21180
21204 void updateMachineState (
21205 in MachineState machineState
21206 );
21207
21223 void uninitialize();
21224
21247 void onNetworkAdapterChange (
21248 in INetworkAdapter networkAdapter,
21249 in boolean changeAdapter
21250 );
21251
21274 void onSerialPortChange (
21275 in ISerialPort serialPort
21276 );
21277
21300 void onParallelPortChange (
21301 in IParallelPort parallelPort
21302 );
21303
21326 void onStorageControllerChange();
21327
21354 void onMediumChange (
21355 in IMediumAttachment mediumAttachment,
21356 in boolean force
21357 );
21358
21388 void onStorageDeviceChange (
21389 in IMediumAttachment mediumAttachment,
21390 in boolean remove,
21391 in boolean silent
21392 );
21393
21401 void onClipboardModeChange (
21402 in ClipboardMode clipboardMode
21403 );
21404
21412 void onDragAndDropModeChange (
21413 in DragAndDropMode dragAndDropMode
21414 );
21415
21425 void onCPUChange (
21426 in unsigned long cpu,
21427 in boolean add
21428 );
21429
21437 void onCPUExecutionCapChange (
21438 in unsigned long executionCap
21439 );
21440
21465 void onVRDEServerChange (
21466 in boolean restart
21467 );
21468
21474 void onVideoCaptureChange();
21475
21498 void onUSBControllerChange();
21499
21528 void onSharedFolderChange (
21529 in boolean global
21530 );
21531
21557 void onUSBDeviceAttach (
21558 in IUSBDevice device,
21559 in IVirtualBoxErrorInfo error,
21560 in unsigned long maskedInterfaces
21561 );
21562
21588 void onUSBDeviceDetach (
21589 in wstringUUID id,
21590 in IVirtualBoxErrorInfo error
21591 );
21592
21610 void onShowWindow (
21611 in boolean check,
21612 out boolean canShow,
21613 out long long winId
21614 );
21615
21623 void onBandwidthGroupChange (
21624 in IBandwidthGroup bandwidthGroup
21625 );
21626
21650 void accessGuestProperty (
21651 in wstring name,
21652 in wstring value,
21653 in wstring flags,
21654 in boolean isSetter,
21655 out wstring retValue,
21656 out long long retTimestamp,
21657 out wstring retFlags
21658 );
21659
21707 void enumerateGuestProperties (
21708 in wstring patterns,
21709 out wstring[] keys,
21710 out wstring[] values,
21711 out long long[] timestamps,
21712 out wstring[] flags
21713 );
21714
21749 void onlineMergeMedium (
21750 in IMediumAttachment mediumAttachment,
21751 in unsigned long sourceIdx,
21752 in unsigned long targetIdx,
21753 in IProgress progress
21754 );
21755
21779 void enableVMMStatistics (
21780 in boolean enable
21781 );
21782
21810 void pauseWithReason (
21811 in Reason reason
21812 );
21813
21841 void resumeWithReason (
21842 in Reason reason
21843 );
21844
21874 void saveStateWithReason (
21875 in Reason reason,
21876 [retval] out IProgress progress
21877 );
21878
21902 void assignMachine (
21903 in IMachine machine,
21904 in LockType lockType,
21905 in wstring tokenId
21906 );
21907
21931 void assignMachine (
21932 in IMachine machine,
21933 in LockType lockType,
21934 in IToken token
21935 );
21936
21937 };
21938
21997 interface ISession : $unknown
21998 {
22002 readonly attribute SessionState state;
22003
22011 readonly attribute SessionType type;
22012
22016 readonly attribute IMachine machine;
22017
22021 readonly attribute IConsole console;
22022
22054 void unlockMachine();
22055
22056 };
22057
22080 interface IStorageController : $unknown
22081 {
22090 readonly attribute wstring name;
22091
22097 readonly attribute unsigned long maxDevicesPerPortCount;
22098
22104 readonly attribute unsigned long minPortCount;
22105
22111 readonly attribute unsigned long maxPortCount;
22112
22118 attribute unsigned long instance;
22119
22128 attribute unsigned long portCount;
22129
22135 readonly attribute StorageBus bus;
22136
22149 attribute StorageControllerType controllerType;
22150
22165 attribute boolean useHostIOCache;
22166
22172 readonly attribute boolean bootable;
22173
22174 };
22175
22199 interface IManagedObjectRef : $unknown
22200 {
22207 void getInterfaceName (
22208 [retval] out wstring return
22209 );
22210
22218 void release();
22219
22220 };
22221
22230 interface IWebsessionManager : $unknown
22231 {
22240 void logon (
22241 in wstring username,
22242 in wstring password,
22243 [retval] out IVirtualBox return
22244 );
22245
22255 void getSessionObject (
22256 in IVirtualBox refIVirtualBox,
22257 [retval] out ISession return
22258 );
22259
22267 void logoff (
22268 in IVirtualBox refIVirtualBox
22269 );
22270
22271 };
22272
22281 interface IPerformanceMetric : $unknown
22282 {
22288 readonly attribute wstring metricName;
22289
22295 readonly attribute $unknown object;
22296
22302 readonly attribute wstring description;
22303
22309 readonly attribute unsigned long period;
22310
22320 readonly attribute unsigned long count;
22321
22327 readonly attribute wstring unit;
22328
22334 readonly attribute long minimumValue;
22335
22341 readonly attribute long maximumValue;
22342
22343 };
22344
22451 interface IPerformanceCollector : $unknown
22452 {
22463 readonly attribute wstring[] metricNames;
22464
22488 void getMetrics (
22489 in wstring[] metricNames,
22490 in $unknown[] objects,
22491 [retval] out IPerformanceMetric[] metrics
22492 );
22493
22532 void setupMetrics (
22533 in wstring[] metricNames,
22534 in $unknown[] objects,
22535 in unsigned long period,
22536 in unsigned long count,
22537 [retval] out IPerformanceMetric[] affectedMetrics
22538 );
22539
22568 void enableMetrics (
22569 in wstring[] metricNames,
22570 in $unknown[] objects,
22571 [retval] out IPerformanceMetric[] affectedMetrics
22572 );
22573
22602 void disableMetrics (
22603 in wstring[] metricNames,
22604 in $unknown[] objects,
22605 [retval] out IPerformanceMetric[] affectedMetrics
22606 );
22607
22697 void queryMetricsData (
22698 in wstring[] metricNames,
22699 in $unknown[] objects,
22700 out wstring[] returnMetricNames,
22701 out $unknown[] returnObjects,
22702 out wstring[] returnUnits,
22703 out unsigned long[] returnScales,
22704 out unsigned long[] returnSequenceNumbers,
22705 out unsigned long[] returnDataIndices,
22706 out unsigned long[] returnDataLengths,
22707 [retval] out long[] returnData
22708 );
22709
22710 };
22711
22719 interface INATEngine : $unknown
22720 {
22725 attribute wstring network;
22726
22733 attribute wstring hostIP;
22734
22739 attribute wstring TFTPPrefix;
22740
22745 attribute wstring TFTPBootFile;
22746
22754 attribute wstring TFTPNextServer;
22755
22759 attribute unsigned long aliasMode;
22760
22764 attribute boolean DNSPassDomain;
22765
22770 attribute boolean DNSProxy;
22771
22776 attribute boolean DNSUseHostResolver;
22777
22782 readonly attribute wstring[] redirects;
22783
22799 void setNetworkSettings (
22800 in unsigned long mtu,
22801 in unsigned long sockSnd,
22802 in unsigned long sockRcv,
22803 in unsigned long TcpWndSnd,
22804 in unsigned long TcpWndRcv
22805 );
22806
22811 void getNetworkSettings (
22812 out unsigned long mtu,
22813 out unsigned long sockSnd,
22814 out unsigned long sockRcv,
22815 out unsigned long TcpWndSnd,
22816 out unsigned long TcpWndRcv
22817 );
22818
22838 void addRedirect (
22839 in wstring name,
22840 in NATProtocol proto,
22841 in wstring hostIP,
22842 in unsigned short hostPort,
22843 in wstring guestIP,
22844 in unsigned short guestPort
22845 );
22846
22852 void removeRedirect (
22853 in wstring name
22854 );
22855
22856 };
22857
22866 interface IExtPackPlugIn : $unknown
22867 {
22871 readonly attribute wstring name;
22872
22876 readonly attribute wstring description;
22877
22883 readonly attribute wstring frontend;
22884
22888 readonly attribute wstring modulePath;
22889
22890 };
22891
22900 interface IExtPackBase : $unknown
22901 {
22905 readonly attribute wstring name;
22906
22910 readonly attribute wstring description;
22911
22923 readonly attribute wstring version;
22924
22928 readonly attribute unsigned long revision;
22929
22939 readonly attribute wstring edition;
22940
22944 readonly attribute wstring VRDEModule;
22945
22949 readonly attribute IExtPackPlugIn[] plugIns;
22950
22960 readonly attribute boolean usable;
22961
22968 readonly attribute wstring whyUnusable;
22969
22973 readonly attribute boolean showLicense;
22974
22983 readonly attribute wstring license;
22984
23008 void queryLicense (
23009 in wstring preferredLocale,
23010 in wstring preferredLanguage,
23011 in wstring format,
23012 [retval] out wstring licenseText
23013 );
23014
23015 };
23016
23025 interface IExtPack : IExtPackBase
23026 {
23038 void queryObject (
23039 in wstring objUuid,
23040 [retval] out $unknown returnInterface
23041 );
23042
23043 };
23044
23054 interface IExtPackFile : IExtPackBase
23055 {
23061 readonly attribute wstring filePath;
23062
23081 void install (
23082 in boolean replace,
23083 in wstring displayInfo,
23084 [retval] out IProgress progess
23085 );
23086
23087 };
23088
23099 interface IExtPackManager : $unknown
23100 {
23106 readonly attribute IExtPack[] installedExtPacks;
23107
23125 void find (
23126 in wstring name,
23127 [retval] out IExtPack returnData
23128 );
23129
23141 void openExtPackFile (
23142 in wstring path,
23143 [retval] out IExtPackFile file
23144 );
23145
23164 void uninstall (
23165 in wstring name,
23166 in boolean forcedRemoval,
23167 in wstring displayInfo,
23168 [retval] out IProgress progess
23169 );
23170
23174 void cleanup();
23175
23188 void queryAllPlugInsForFrontend (
23189 in wstring frontendName,
23190 [retval] out wstring[] plugInModules
23191 );
23192
23200 void isExtPackUsable (
23201 in wstring name,
23202 [retval] out boolean usable
23203 );
23204
23205 };
23206
23212 interface IBandwidthGroup : $unknown
23213 {
23217 readonly attribute wstring name;
23218
23222 readonly attribute BandwidthGroupType type;
23223
23227 readonly attribute unsigned long reference;
23228
23233 attribute long long maxBytesPerSec;
23234
23235 };
23236
23245 interface IBandwidthControl : $unknown
23246 {
23252 readonly attribute unsigned long numGroups;
23253
23266 void createBandwidthGroup (
23267 in wstring name,
23268 in BandwidthGroupType type,
23269 in long long maxBytesPerSec
23270 );
23271
23279 void deleteBandwidthGroup (
23280 in wstring name
23281 );
23282
23292 void getBandwidthGroup (
23293 in wstring name,
23294 [retval] out IBandwidthGroup bandwidthGroup
23295 );
23296
23304 void getAllBandwidthGroups (
23305 [retval] out IBandwidthGroup[] bandwidthGroups
23306 );
23307
23308 };
23309
23322 interface IVirtualBoxClient : $unknown
23323 {
23329 readonly attribute IVirtualBox virtualBox;
23330
23336 readonly attribute ISession session;
23337
23343 readonly attribute IEventSource eventSource;
23344
23355 void checkMachineError (
23356 in IMachine machine
23357 );
23358
23359 };
23360
23374 interface IEventSource : $unknown
23375 {
23381 void createListener (
23382 [retval] out IEventListener listener
23383 );
23384
23400 void createAggregator (
23401 in IEventSource[] subordinates,
23402 [retval] out IEventSource result
23403 );
23404
23437 void registerListener (
23438 in IEventListener listener,
23439 in VBoxEventType[] interesting,
23440 in boolean active
23441 );
23442
23451 void unregisterListener (
23452 in IEventListener listener
23453 );
23454
23469 void fireEvent (
23470 in IEvent event,
23471 in long timeout,
23472 [retval] out boolean result
23473 );
23474
23499 void getEvent (
23500 in IEventListener listener,
23501 in long timeout,
23502 [retval] out IEvent event
23503 );
23504
23516 void eventProcessed (
23517 in IEventListener listener,
23518 in IEvent event
23519 );
23520
23521 };
23522
23532 interface IEventListener : $unknown
23533 {
23546 void handleEvent (
23547 in IEvent event
23548 );
23549
23550 };
23551
23628 interface IEvent : $unknown
23629 {
23635 readonly attribute VBoxEventType type;
23636
23642 readonly attribute IEventSource source;
23643
23654 readonly attribute boolean waitable;
23655
23662 void setProcessed();
23663
23677 void waitProcessed (
23678 in long timeout,
23679 [retval] out boolean result
23680 );
23681
23682 };
23683
23689 interface IReusableEvent : IEvent
23690 {
23694 readonly attribute unsigned long generation;
23695
23702 void reuse();
23703
23704 };
23705
23711 interface IMachineEvent : IEvent
23712 {
23716 readonly attribute wstringUUID machineId;
23717
23718 };
23719
23725 interface IMachineStateChangedEvent : IMachineEvent
23726 {
23730 readonly attribute MachineState state;
23731
23732 };
23733
23741 interface IMachineDataChangedEvent : IMachineEvent
23742 {
23749 readonly attribute boolean temporary;
23750
23751 };
23752
23761 interface IMediumRegisteredEvent : IEvent
23762 {
23766 readonly attribute wstringUUID mediumId;
23767
23771 readonly attribute DeviceType mediumType;
23772
23779 readonly attribute boolean registered;
23780
23781 };
23782
23791 interface IMachineRegisteredEvent : IMachineEvent
23792 {
23799 readonly attribute boolean registered;
23800
23801 };
23802
23812 interface ISessionStateChangedEvent : IMachineEvent
23813 {
23819 readonly attribute SessionState state;
23820
23821 };
23822
23830 interface IGuestPropertyChangedEvent : IMachineEvent
23831 {
23837 readonly attribute wstring name;
23838
23844 readonly attribute wstring value;
23845
23851 readonly attribute wstring flags;
23852
23853 };
23854
23860 interface ISnapshotEvent : IMachineEvent
23861 {
23865 readonly attribute wstringUUID snapshotId;
23866
23867 };
23868
23878 interface ISnapshotTakenEvent : ISnapshotEvent
23879 {
23880 };
23881
23898 interface ISnapshotDeletedEvent : ISnapshotEvent
23899 {
23900 };
23901
23911 interface ISnapshotChangedEvent : ISnapshotEvent
23912 {
23913 };
23914
23923 interface IMousePointerShapeChangedEvent : IEvent
23924 {
23930 readonly attribute boolean visible;
23931
23937 readonly attribute boolean alpha;
23938
23944 readonly attribute unsigned long xhot;
23945
23951 readonly attribute unsigned long yhot;
23952
23958 readonly attribute unsigned long width;
23959
23965 readonly attribute unsigned long height;
23966
23999 readonly attribute octet[] shape;
24000
24001 };
24002
24011 interface IMouseCapabilityChangedEvent : IEvent
24012 {
24018 readonly attribute boolean supportsAbsolute;
24019
24025 readonly attribute boolean supportsRelative;
24026
24032 readonly attribute boolean supportsMultiTouch;
24033
24039 readonly attribute boolean needsHostCursor;
24040
24041 };
24042
24051 interface IKeyboardLedsChangedEvent : IEvent
24052 {
24058 readonly attribute boolean numLock;
24059
24065 readonly attribute boolean capsLock;
24066
24072 readonly attribute boolean scrollLock;
24073
24074 };
24075
24084 interface IStateChangedEvent : IEvent
24085 {
24091 readonly attribute MachineState state;
24092
24093 };
24094
24104 interface IAdditionsStateChangedEvent : IEvent
24105 {
24106 };
24107
24118 interface INetworkAdapterChangedEvent : IEvent
24119 {
24125 readonly attribute INetworkAdapter networkAdapter;
24126
24127 };
24128
24139 interface ISerialPortChangedEvent : IEvent
24140 {
24146 readonly attribute ISerialPort serialPort;
24147
24148 };
24149
24160 interface IParallelPortChangedEvent : IEvent
24161 {
24167 readonly attribute IParallelPort parallelPort;
24168
24169 };
24170
24180 interface IStorageControllerChangedEvent : IEvent
24181 {
24182 };
24183
24193 interface IMediumChangedEvent : IEvent
24194 {
24200 readonly attribute IMediumAttachment mediumAttachment;
24201
24202 };
24203
24211 interface IClipboardModeChangedEvent : IEvent
24212 {
24218 readonly attribute ClipboardMode clipboardMode;
24219
24220 };
24221
24229 interface IDragAndDropModeChangedEvent : IEvent
24230 {
24236 readonly attribute DragAndDropMode dragAndDropMode;
24237
24238 };
24239
24247 interface ICPUChangedEvent : IEvent
24248 {
24254 readonly attribute unsigned long CPU;
24255
24261 readonly attribute boolean add;
24262
24263 };
24264
24272 interface ICPUExecutionCapChangedEvent : IEvent
24273 {
24279 readonly attribute unsigned long executionCap;
24280
24281 };
24282
24290 interface IGuestKeyboardEvent : IEvent
24291 {
24297 readonly attribute long[] scancodes;
24298
24299 };
24300
24308 interface IGuestMouseEvent : IReusableEvent
24309 {
24315 readonly attribute GuestMouseEventMode mode;
24316
24322 readonly attribute long x;
24323
24329 readonly attribute long y;
24330
24336 readonly attribute long z;
24337
24343 readonly attribute long w;
24344
24350 readonly attribute long buttons;
24351
24352 };
24353
24361 interface IGuestMultiTouchEvent : IEvent
24362 {
24368 readonly attribute long contactCount;
24369
24375 readonly attribute short[] xPositions;
24376
24382 readonly attribute short[] yPositions;
24383
24389 readonly attribute unsigned short[] contactIds;
24390
24398 readonly attribute unsigned short[] contactFlags;
24399
24405 readonly attribute unsigned long scanTime;
24406
24407 };
24408
24414 interface IGuestSessionEvent : IEvent
24415 {
24419 readonly attribute IGuestSession session;
24420
24421 };
24422
24430 interface IGuestSessionStateChangedEvent : IGuestSessionEvent
24431 {
24437 readonly attribute unsigned long id;
24438
24444 readonly attribute GuestSessionStatus status;
24445
24455 readonly attribute IVirtualBoxErrorInfo error;
24456
24457 };
24458
24466 interface IGuestSessionRegisteredEvent : IGuestSessionEvent
24467 {
24474 readonly attribute boolean registered;
24475
24476 };
24477
24483 interface IGuestProcessEvent : IGuestSessionEvent
24484 {
24490 readonly attribute IGuestProcess process;
24491
24497 readonly attribute unsigned long pid;
24498
24499 };
24500
24508 interface IGuestProcessRegisteredEvent : IGuestProcessEvent
24509 {
24516 readonly attribute boolean registered;
24517
24518 };
24519
24527 interface IGuestProcessStateChangedEvent : IGuestProcessEvent
24528 {
24534 readonly attribute ProcessStatus status;
24535
24545 readonly attribute IVirtualBoxErrorInfo error;
24546
24547 };
24548
24556 interface IGuestProcessIOEvent : IGuestProcessEvent
24557 {
24564 readonly attribute unsigned long handle;
24565
24571 readonly attribute unsigned long processed;
24572
24573 };
24574
24584 interface IGuestProcessInputNotifyEvent : IGuestProcessIOEvent
24585 {
24591 readonly attribute ProcessInputStatus status;
24592
24593 };
24594
24602 interface IGuestProcessOutputEvent : IGuestProcessIOEvent
24603 {
24609 readonly attribute octet[] data;
24610
24611 };
24612
24618 interface IGuestFileEvent : IGuestSessionEvent
24619 {
24625 readonly attribute IGuestFile file;
24626
24627 };
24628
24636 interface IGuestFileRegisteredEvent : IGuestFileEvent
24637 {
24644 readonly attribute boolean registered;
24645
24646 };
24647
24655 interface IGuestFileStateChangedEvent : IGuestFileEvent
24656 {
24662 readonly attribute FileStatus status;
24663
24673 readonly attribute IVirtualBoxErrorInfo error;
24674
24675 };
24676
24684 interface IGuestFileIOEvent : IGuestFileEvent
24685 {
24691 readonly attribute long long offset;
24692
24698 readonly attribute unsigned long processed;
24699
24700 };
24701
24709 interface IGuestFileOffsetChangedEvent : IGuestFileIOEvent
24710 {
24711 };
24712
24720 interface IGuestFileReadEvent : IGuestFileIOEvent
24721 {
24727 readonly attribute octet[] data;
24728
24729 };
24730
24738 interface IGuestFileWriteEvent : IGuestFileIOEvent
24739 {
24740 };
24741
24752 interface IVRDEServerChangedEvent : IEvent
24753 {
24754 };
24755
24765 interface IVRDEServerInfoChangedEvent : IEvent
24766 {
24767 };
24768
24776 interface IVideoCaptureChangedEvent : IEvent
24777 {
24778 };
24779
24790 interface IUSBControllerChangedEvent : IEvent
24791 {
24792 };
24793
24817 interface IUSBDeviceStateChangedEvent : IEvent
24818 {
24824 readonly attribute IUSBDevice device;
24825
24831 readonly attribute boolean attached;
24832
24838 readonly attribute IVirtualBoxErrorInfo error;
24839
24840 };
24841
24857 interface ISharedFolderChangedEvent : IEvent
24858 {
24864 readonly attribute Scope scope;
24865
24866 };
24867
24919 interface IRuntimeErrorEvent : IEvent
24920 {
24926 readonly attribute boolean fatal;
24927
24933 readonly attribute wstring id;
24934
24940 readonly attribute wstring message;
24941
24942 };
24943
24951 interface IEventSourceChangedEvent : IEvent
24952 {
24958 readonly attribute IEventListener listener;
24959
24965 readonly attribute boolean add;
24966
24967 };
24968
24977 interface IExtraDataChangedEvent : IEvent
24978 {
24985 readonly attribute wstringUUID machineId;
24986
24992 readonly attribute wstring key;
24993
24999 readonly attribute wstring value;
25000
25001 };
25002
25008 interface IVetoEvent : IEvent
25009 {
25019 void addVeto (
25020 in wstring reason
25021 );
25022
25032 void isVetoed (
25033 [retval] out boolean result
25034 );
25035
25045 void getVetos (
25046 [retval] out wstring[] result
25047 );
25048
25049 };
25050
25060 interface IExtraDataCanChangeEvent : IVetoEvent
25061 {
25068 readonly attribute wstringUUID machineId;
25069
25075 readonly attribute wstring key;
25076
25082 readonly attribute wstring value;
25083
25084 };
25085
25101 interface ICanShowWindowEvent : IVetoEvent
25102 {
25103 };
25104
25136 interface IShowWindowEvent : IEvent
25137 {
25146 attribute long long winId;
25147
25148 };
25149
25157 interface INATRedirectEvent : IMachineEvent
25158 {
25164 readonly attribute unsigned long slot;
25165
25171 readonly attribute boolean remove;
25172
25178 readonly attribute wstring name;
25179
25185 readonly attribute NATProtocol proto;
25186
25192 readonly attribute wstring hostIP;
25193
25199 readonly attribute long hostPort;
25200
25206 readonly attribute wstring guestIP;
25207
25213 readonly attribute long guestPort;
25214
25215 };
25216
25229 interface IHostPCIDevicePlugEvent : IMachineEvent
25230 {
25236 readonly attribute boolean plugged;
25237
25244 readonly attribute boolean success;
25245
25251 readonly attribute IPCIDeviceAttachment attachment;
25252
25258 readonly attribute wstring message;
25259
25260 };
25261
25270 interface IVBoxSVCAvailabilityChangedEvent : IEvent
25271 {
25277 readonly attribute boolean available;
25278
25279 };
25280
25288 interface IBandwidthGroupChangedEvent : IEvent
25289 {
25295 readonly attribute IBandwidthGroup bandwidthGroup;
25296
25297 };
25298
25306 interface IGuestMonitorChangedEvent : IEvent
25307 {
25313 readonly attribute GuestMonitorChangedEventType changeType;
25314
25320 readonly attribute unsigned long screenId;
25321
25328 readonly attribute unsigned long originX;
25329
25336 readonly attribute unsigned long originY;
25337
25344 readonly attribute unsigned long width;
25345
25352 readonly attribute unsigned long height;
25353
25354 };
25355
25363 interface IGuestUserStateChangedEvent : IEvent
25364 {
25370 readonly attribute wstring name;
25371
25378 readonly attribute wstring domain;
25379
25386 readonly attribute GuestUserState state;
25387
25393 readonly attribute wstring stateDetails;
25394
25395 };
25396
25406 interface IStorageDeviceChangedEvent : IEvent
25407 {
25413 readonly attribute IMediumAttachment storageDevice;
25414
25420 readonly attribute boolean removed;
25421
25427 readonly attribute boolean silent;
25428
25429 };
25430
25431 interface INATNetworkChangedEvent : IEvent
25432 {
25433 readonly attribute wstring networkName;
25434
25435 };
25436
25437 interface INATNetworkStartStopEvent : INATNetworkChangedEvent
25438 {
25444 readonly attribute boolean startEvent;
25445
25446 };
25447
25448 interface INATNetworkAlterEvent : INATNetworkChangedEvent
25449 {
25450 };
25451
25452 interface INATNetworkCreationDeletionEvent : INATNetworkAlterEvent
25453 {
25454 readonly attribute boolean creationEvent;
25455
25456 };
25457
25458 interface INATNetworkSettingEvent : INATNetworkAlterEvent
25459 {
25460 readonly attribute boolean enabled;
25461
25462 readonly attribute wstring network;
25463
25464 readonly attribute wstring gateway;
25465
25466 readonly attribute boolean advertiseDefaultIPv6RouteEnabled;
25467
25468 readonly attribute boolean needDhcpServer;
25469
25470 };
25471
25472 interface INATNetworkPortForwardEvent : INATNetworkAlterEvent
25473 {
25474 readonly attribute boolean create;
25475
25476 readonly attribute boolean ipv6;
25477
25478 readonly attribute wstring name;
25479
25480 readonly attribute NATProtocol proto;
25481
25482 readonly attribute wstring hostIp;
25483
25484 readonly attribute long hostPort;
25485
25486 readonly attribute wstring guestIp;
25487
25488 readonly attribute long guestPort;
25489
25490 };
25491
25492 interface IHostNameResolutionConfigurationChangeEvent : IEvent
25493 {
25494 };
25495
25496