Changeset 15828 in vbox for trunk/src/VBox/Main

Timestamp:

Jan 7, 2009 11:07:53 AM (16 years ago)

Author:

vboxsync

Message:

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

• IUSBController::createDeviceFilter
• IUSBController::insertDeviceFilter
• IUSBController::removeDeviceFilter

File:

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

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

@@ -10238 +10238 @@
         <link to="#insertDeviceFilter()"/>.
 
+        <result name="VBOX_E_INVALID_VM_STATE">
+          The virtual machine is not mutable.
+        </result>
+
         <see>#deviceFilters</see>
       </desc>
@@ -10266 +10270 @@
         </note>
 
+        <result name="VBOX_E_INVALID_VM_STATE">
+          Virtual machine is not mutable.
+        </result>
+        <result name="E_INVALIDARG">
+          USB device filter not created within this VirtualBox instance.
+        </result>
+        <result name="VBOX_E_INVALID_OBJECT_STATE">
+          USB device filter already in list.
+        </result>
+
         <see>#deviceFilters</see>
       </desc>
@@ -10286 +10300 @@
 
         <see>#deviceFilters</see>
+
+        <result name="VBOX_E_INVALID_VM_STATE">
+          Virtual machine is not mutable.
+        </result>
+        <result name="E_INVALIDARG">
+          USB device filter list empty or invalid @a position.
+        </result>
+
       </desc>
       <param name="position" type="unsigned long" dir="in">