Changeset 105255 in vbox

Timestamp:

Jul 10, 2024 9:42:12 AM (5 months ago)

Author:

vboxsync

Message:

Main,FE/VBoxManage: Add method to query which execution engines supported by a build are actually supported by the host. Primarily for querying whether the native API is accessible on a host [missing file]

File:

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

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

@@ -12313 +12313 @@
   <interface
     name="IHost" extends="$unknown"
-    uuid="e54f6256-97a7-4947-8a78-10c013ddf4b8"
+    uuid="89b05229-cecf-4ef6-816f-c0c13f2c4da3"
     wsmap="managed"
     rest="managed"
@@ -12797 +12797 @@
         <desc>Checks for new Guest Additions versions.</desc>
     </attribute>
+
+    <method name="isExecutionEngineSupported">
+      <desc>
+        Returns whether the given execution engine is supported on the host.
+        This is primarily to check whether the native API is supported (think
+        of Hyper-V not being available due to not running in a Hyper-V root partition).
+      </desc>
+      <param name="cpuArchitecture" type="CPUArchitecture" dir="in">
+        <desc>The guest CPU architecture to check the execution engine for.</desc>
+      </param>
+      <param name="executionEngine" type="VMExecutionEngine" dir="in">
+        <desc>The execution engine to check.</desc>
+      </param>
+      <param name="isSupported" type="boolean" dir="return">
+        <desc>Flag indicating whether the given execution engine is supported on the host.</desc>
+      </param>
+    </method>
 
   </interface>