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

Timestamp:

Dec 31, 2022 9:44:15 PM (2 years ago)

Author:

vboxsync

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

155021

Message:

Main: Added resizeAndCloneTo(). Modified cloneTo(), bugref:10090

File:

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

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

@@ -18126 +18126 @@
   <interface
     name="IMedium" extends="$unknown"
-    uuid="ad47ad09-787b-44ab-b343-a082a3f2dfb1"
+    uuid="dbe1d807-5fa1-482f-9121-37b8fd855348"
     wsmap="managed"
     rest="managed"
@@ -19212 +19212 @@
       <param name="target" type="IMedium" dir="in">
         <desc>Target medium.</desc>
+      </param>
+      <param name="variant" type="MediumVariant" safearray="yes" dir="in">
+        <desc>Exact image variant which should be created (as a combination of
+          <link to="MediumVariant" /> flags).</desc>
+      </param>
+      <param name="parent" type="IMedium" dir="in">
+        <desc>Parent of the cloned medium.</desc>
+      </param>
+      <param name="progress" type="IProgress" dir="return">
+        <desc>Progress object to track the operation completion.</desc>
+      </param>
+    </method>
+
+    <method name="resizeAndCloneTo">
+      <rest request="post" path="/mediums/{mediumid}/actions/"/>
+
+      <desc>
+        This is a helper function that combines the functionality of
+        <link to="IMedium::cloneTo"/> and <link to="IMedium::resize"/>. The target medium will take the
+        contents of the calling medium.
+        <result name="E_NOTIMPL">
+          The specified cloning variant is not supported at the moment.
+        </result>
+      </desc>
+
+      <param name="target" type="IMedium" dir="in">
+        <desc>Target medium.</desc>
+      </param>
+      <param name="logicalSize" type="long long" dir="in">
+        <desc>New nominal capacity of the medium in bytes.</desc>
       </param>
       <param name="variant" type="MediumVariant" safearray="yes" dir="in">