Changeset 15661 in vbox

Timestamp:

Dec 18, 2008 2:21:08 PM (16 years ago)

Author:

vboxsync

Message:

#3285: Improve error handling API to include unique error numbers
Document

• IDVDDrive::mountImage

Location:

trunk/src/VBox/Main

Files:

• DVDDriveImpl.cpp (modified) (1 diff)
• idl/VirtualBox.xidl (modified) (1 diff)

trunk/src/VBox/Main/DVDDriveImpl.cpp

@@ -246 +246 @@
 {
     Guid imageId = aImageId;
-    if (imageId.isEmpty())
-        return E_INVALIDARG;
+    CheckComArgExpr(aImageId, !imageId.isEmpty());
 
     AutoCaller autoCaller (this);

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

@@ -8766 +8766 @@
 
     <method name="mountImage">
-      <desc>Mounts a CD/DVD image with the specified UUID.</desc>
+      <desc>Mounts a CD/DVD image with the specified UUID.
+
+        <result name="VBOX_E_FILE_ERROR">
+          Invalid image file location.
+        </result>
+        <result name="VBOX_E_OBJECT_NOT_FOUND">
+          Could not find a CD/DVD image matching @a imageID.
+        </result>
+        <result name="VBOX_E_INVALID_OBJECT_STATE">
+          Invalid media state.
+        </result>
+
+      </desc>
       <param name="imageId" type="uuid" dir="in"/>
     </method>