Changeset 72476 in vbox for trunk/src/VBox/Main/idl/VirtualBox.xidl

Timestamp:

Jun 7, 2018 1:49:48 PM (7 years ago)

Author:

vboxsync

svn:sync-xref-src-repo-rev:

122961

Message:

Main/Appliance: Teach importing new tricks: importing to specific location (by settings file name or base folder) and also importing straight into a group. Lots of cleanup and minor fixing (bad code quality due to lots of copy/paste, and what's worse is that the original code was broken already, using the variables inconsistently), plus some smallish coding style cleaup. Much more needed. Also fixed the incomplete use of the VM name on expert (the one in the VBox XML was not changed, and it's the preferred name on import).
VBoxManage: small updates to reflect the new features (and actually offer setting the VM name on export, which is something the GUI could do for a long time).

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (2 diffs)

trunk/src/VBox/Main/idl/VirtualBox.xidl

@@ -3519 +3519 @@
   <enum
     name="VirtualSystemDescriptionType"
-    uuid="303c0900-a746-4612-8c67-79003e91f459"
+    uuid="e43225cb-09fc-4e70-a56c-6dad3bcb48a6"
     >
     <desc>Used with <link to="IVirtualSystemDescription" /> to describe the type of
@@ -3548 +3548 @@
     <const name="SoundCard" value="23" />
     <const name="SettingsFile" value="24">
-      <desc>Not used/implemented right now, will be added later in 4.1.x.</desc>
+      <desc>Optional, may be unset by the API caller. If this is changed by the
+        API caller it defines the absolute path of the VM settings file and
+        therefore also the VM folder with highest priority.</desc>
+    </const>
+    <const name="BaseFolder" value="25">
+      <desc>Optional, may be unset by the API caller. If set (and
+        <link to="#SettingsFile"/> is not changed), defines the VM base folder
+        (taking the primary group into account if also set).</desc>
+    </const>
+    <const name="PrimaryGroup" value="26">
+      <desc>Optional, empty by default and may be unset by the API caller.
+        Defines the primary group of the VM after import. May influence the
+        selection of the VM folder. Additional groups may be configured later
+        using <link to="IMachine::groups"/>, after importing.</desc>
     </const>
   </enum>