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

Timestamp:

May 16, 2007 3:31:49 PM (18 years ago)

Author:

vboxsync

Message:

Main: Ported latest dmik/exp branch changes (r21219:21226) into the trunk.

File:

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

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

@@ -365 +365 @@
             Sometimes invocation of some component's method may involve
             methods of other components that may also fail (independently of
-            this method's failure), or a series of non-fatal errors may precede
-            a fatal error that causes method failure. In cases like that, it
-            may be desirable to preserve information about all errors happened
-            during method invocation and deliver it to the caller. The <link
-            to="#next"/> attribute is intended specifically for this purpose
-            and allows to represent a chain of errors through a single
-            IVirtualBoxErrorInfo instance set after method invocation.
+            this method's failure), or a series of non-fatal errors may
+            precede a fatal error that causes method failure. In cases like
+            that, it may be desirable to preserve information about all errors
+            happened during method invocation and deliver it to the
+            caller. The <link to="#next"/> attribute is intended specifically
+            for this purpose and allows to represent a chain of errors through
+            a single IVirtualBoxErrorInfo instance set after method
+            invocation. Note that errors are stored to a chain in the reverse
+            order, i.e. the initial error object you query right after method
+            invocation is the last error set by the callee, the object it
+            points to in the @a next attribute is the previous error and so
+            on, up to the first error (which is the last in the chain).
         </desc>