Changeset 14700

Timestamp:

11/27/08 13:23:25 (1 month ago)

Author:

vboxsync

Message:

#3285: Improve error handling API to include unique error numbers
document createDiffStorage's E_VBOX_OBJECT_IN_USE.

Files:

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

trunk/src/VBox/Main/HardDisk2Impl.cpp

@@ -1929 +1929 @@
- * As opposed to the CreateDiffStorage() method, this method doesn't try to lock
- * this hard disk for reading assuming that the caller has already done so. This
-
+n
- * locked for writing and must remain such). Note however that if @a aWait is
- * @c false and this method returns a success then the thread started by
-*
+
- * MediaState_LockedWrite state) so make sure the hard disk is either in
- * MediaState_LockedWrite or call #LockRead() before calling this method! If @a
@@ -1940 +1940 @@
- * If @a aProgress is not NULL but the object it points to is @c null then a new
- * progress object will be created and assigned to @a *aProgress on success,
-
+@a a
- * progress object is created/used at all.
- *
@@ -1955 +1955 @@
- *                      an asynchronous thread.
- *
-
+@a 
- */
-HRESULT HardDisk2::createDiffStorage (ComObjPtr <HardDisk2> &aTarget,
@@ -2000 +2000 @@
-            if (it->snapshotIds.size() == 0)
-            {
-E_FAIL
+VBOX_E_OBJECT_IN_USE
-                    tr ("Hard disk '%ls' is attached to a virtual machine "
-                        "with UUID {%RTuuid}. No differencing hard disks "

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

@@ -7379 +7379 @@
-
-        <result name="VBOX_E_OBJECT_IN_USE">
-still 
+
-        </result>
-      </desc>
@@ -7407 +7407 @@
-
-        <note>
-placed
+set
-          state for the duration of this operation.
-        </note>
-
+
+
+
+
+
-        <desc>Target hard disk.</desc>
-      </param>