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

Timestamp:

Aug 17, 2018 5:56:34 PM (7 years ago)

Author:

vboxsync

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

124424

Message:

Main/Progress+Appliance+Machine: Turn IProgress::waitForAsyncProgressCompletion into an internal method. It is not needed by any client code outside the API, it's simply is too special. Also include the error propagation which it originally skipped (leding to reduntant code in the calling code). Remove a replicated version of it from the Appliance code which seems to be the half-forgotten ancestor of the method in IProgress. Adapt the users of the method to the new internal method, which made the code easier to read.

File:

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

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

@@ -14212 +14212 @@
   <interface
     name="IProgress" extends="$unknown"
-    uuid="e0026dc0-0c55-47b1-aa64-d340a396b418"
+    uuid="64c7fb5c-ce8f-4681-9c8c-d523cb4dea3d"
     wsmap="managed"
     reservedMethods="1" reservedAttributes="2"
@@ -14407 +14407 @@
         <desc>
           Maximum time in milliseconds to wait or -1 to wait indefinitely.
-        </desc>
-      </param>
-    </method>
-
-    <method name="waitForAsyncProgressCompletion">
-      <desc>
-          Waits until the other task is completed (including all
-          sub-operations) and forward all changes from the other progress to
-          this progress. This means sub-operation number, description, percent
-          and so on.
-
-          You have to take care on setting up at least the same count on
-          sub-operations in this progress object like there are in the other
-          progress object.
-
-          If the other progress object supports cancel and this object gets any
-          cancel request (when here enabled as well), it will be forwarded to
-          the other progress object.
-
-          If there is an error in the other progress, this error isn't
-          automatically transfered to this progress object. So you have to
-          check any operation error within the other progress object, after
-          this method returns.
-      </desc>
-
-      <param name="pProgressAsync" type="IProgress" dir="in">
-        <desc>
-          The progress object of the asynchrony process.
         </desc>
       </param>