Changeset 42569 in vbox for trunk/src/VBox/Main/idl

Timestamp:

Aug 3, 2012 9:52:23 AM (12 years ago)

Author:

vboxsync

Message:

Main/VirtualBox+Machine: new API method for getting VMs which are in the given groups, plus a bit of performance tuning/simplification

File:

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

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

@@ -1424 +1424 @@
   <interface
     name="IVirtualBox" extends="$unknown"
-    uuid="53789455-fad2-425a-94c8-eb6dc4ceaa05"
+    uuid="3b90eded-f061-432f-9e0f-4b53cc7b6fa0"
     wsmap="managed"
     >
@@ -1837 +1837 @@
       <param name="machine" type="IMachine" dir="return">
         <desc>Machine object, if found.</desc>
+      </param>
+    </method>
+
+    <method name="getMachinesByGroups">
+      <desc>
+        Gets all machine references which are in one of the specified groups.
+      </desc>
+      <param name="groups" type="wstring" dir="in" safearray="yes">
+        <desc>What groups to match. The usual group list rules apply, i.e.
+        passing an empty list will match VMs in the toplevel group, likewise
+        the empty string.</desc>
+      </param>
+      <param name="machines" type="IMachine" dir="return" safearray="yes">
+        <desc>All machines which matched.</desc>
       </param>
     </method>