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

Timestamp:

May 1, 2012 8:02:21 PM (13 years ago)

Author:

vboxsync

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

77706

Message:

backed out r77705 as it broke the builds (webservices)

File:

• trunk/src/VBox/Main/idl/VirtualBox.xidl (modified) (1 diff)

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

@@ -1957 +1957 @@
       <param name="medium" type="IMedium" dir="return">
         <desc>Opened medium object.</desc>
+      </param>
+    </method>
+
+    <method name="findMedium">
+      <desc>
+        Returns a medium of the given type that uses the given fully qualified
+        location or UUID to store medium data.
+
+        The given medium must be known to this VirtualBox installation, i.e.
+        it must be previously created by <link to="#createHardDisk"/> or opened
+        by <link to="#openMedium"/>.
+
+        The search is done by comparing the value of the @a location argument to
+        the <link to="IMedium::location"/> and <link to="IMedium::id" />
+        attributes of each known medium.
+
+        On case sensitive file systems, a case sensitive comparison is performed,
+        otherwise the case of symbols in the file path is ignored.
+
+        <result name="VBOX_E_OBJECT_NOT_FOUND">
+          No medium object matching @a location found.
+        </result>
+      </desc>
+      <param name="location" type="wstring" dir="in">
+        <desc>What to search for. This can either be the UUID or the location string of an open medium.</desc>
+      </param>
+      <param name="type" type="DeviceType" dir="in">
+        <desc>Device type (must be HardDisk, DVD or Floppy)</desc>
+      </param>
+      <param name="medium" type="IMedium" dir="return">
+        <desc>Medium object, if found.</desc>
       </param>
     </method>