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

Timestamp:

Apr 29, 2013 12:30:50 PM (12 years ago)

Author:

vboxsync

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

85374

Message:

Main: Removed IGuestErrorInfo, added new attribute resultDetail to IVirtualBoxErrorInfo for (optionally) providing more details on the error happened.

File:

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

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

@@ -1261 +1261 @@
   <interface
     name="IVirtualBoxErrorInfo" extends="$errorinfo"
-    uuid="f91e6e91-49e1-4fd2-b21e-269003350d06"
+    uuid="c1bcc6d5-7966-481d-ab0b-d0ed73e28135"
     supportsErrorInfo="no"
     wsmap="managed"
@@ -1308 +1308 @@
           In XPCOM, it is the same as nsIException::result.
         </note>
+      </desc>
+    </attribute>
+
+    <attribute name="resultDetail" type="long" readonly="yes">
+      <desc>
+        Optional result data of this error. This will vary depending on the
+        actual error usage. By default this attribute is not being used.
       </desc>
     </attribute>
@@ -9724 +9731 @@
 
   <interface
-    name="IGuestErrorInfo" extends="$unknown"
-    uuid="ab576a37-dcfc-4d80-9a73-493d15e293c4"
-    wsmap="managed"
-    >
-    <desc>
-      The IGuestErrorInfo interface represents extended error information which
-      happened while performing an operation on the guest.
-    </desc>
-
-    <attribute name="result" type="long" readonly="yes">
-      <desc>Runtime (IPRT) error code. See include/iprt/err.h and include/VBox/err.h
-        for details.</desc>
-    </attribute>
-
-    <attribute name="text" type="wstring" readonly="yes">
-      <desc>Text description of the error.</desc>
-    </attribute>
-
-  </interface>
-
-  <interface
     name="IGuestSession" extends="$unknown"
     uuid="c8e8607b-5e67-4073-8f14-146515d0c1ff"
@@ -19977 +19963 @@
       </desc>
     </attribute>
-    <attribute name="error" type="IGuestErrorInfo" readonly="yes">
-      <desc>
-        Extended guest error information in case of new session
-        status is indicating an error.
+    <attribute name="error" type="IVirtualBoxErrorInfo" readonly="yes">
+      <desc>
+        Error information in case of new session status is indicating an error.
+
+        The attribute <link to="IVirtualBoxErrorInfo::resultDetail"/> will contain
+        the runtime (IPRT) error code from the guest. See include/iprt/err.h and
+        include/VBox/err.h for details.
       </desc>
     </attribute>
@@ -20056 +20045 @@
       </desc>
     </attribute>
-    <attribute name="error" type="IGuestErrorInfo" readonly="yes">
-      <desc>
-        Extended guest error information in case of new process
-        status is indicating an error.
+    <attribute name="error" type="IVirtualBoxErrorInfo" readonly="yes">
+      <desc>
+        Error information in case of new session status is indicating an error.
+
+        The attribute <link to="IVirtualBoxErrorInfo::resultDetail"/> will contain
+        the runtime (IPRT) error code from the guest. See include/iprt/err.h and
+        include/VBox/err.h for details.
       </desc>
     </attribute>
@@ -20171 +20163 @@
       </desc>
     </attribute>
-    <attribute name="error" type="IGuestErrorInfo" readonly="yes">
-      <desc>
-        Extended guest error information in case of new file
-        status is indicating an error.
+    <attribute name="error" type="IVirtualBoxErrorInfo" readonly="yes">
+      <desc>
+        Error information in case of new session status is indicating an error.
+
+        The attribute <link to="IVirtualBoxErrorInfo::resultDetail"/> will contain
+        the runtime (IPRT) error code from the guest. See include/iprt/err.h and
+        include/VBox/err.h for details.
       </desc>
     </attribute>