org.virtualbox_5_2
Class IRuntimeErrorEvent

java.lang.Object
  extended by org.virtualbox_5_2.IUnknown
      extended by org.virtualbox_5_2.IEvent
          extended by org.virtualbox_5_2.IRuntimeErrorEvent

public class IRuntimeErrorEvent
extends IEvent

Notification when an error happens during the virtual machine execution. There are three kinds of runtime errors:

Fatalerrors are indicated by the fatal parameter set to true. In case of fatal errors, the virtual machine execution is always paused before calling this notification, and the notification handler is supposed either to immediately save the virtual machine state usingIMachine.saveState()or power it off usingIConsole.powerDown(). Resuming the execution can lead to unpredictable results.Non-fatalerrors and warnings are indicated by the fatal parameter set to false. If the virtual machine is in the Paused state by the time the error notification is received, it means that the user cantry to resumethe machine execution after attempting to solve the problem that caused the error. In this case, the notification handler is supposed to show an appropriate message to the user (depending on the value of the id parameter) that offers several actions such asRetry,SaveorPower Off. If the user wants to retry, the notification handler should continue the machine execution using theIConsole.resume()call. If the machine execution is not Paused during this notification, then it means this notification is awarning(for example, about a fatal condition that can happen very soon); no immediate action is required from the user, the machine continues its normal execution. Note that in either case the notification handlermust notperform any action directly on a thread where this notification is called. Everything it is allowed to do is to post a message to another thread that will then talk to the user and take the corresponding action. Currently, the following error identifiers are known: Interface ID: {883DD18B-0721-4CDE-867C-1A82ABAF914C}


Field Summary
 
Fields inherited from class org.virtualbox_5_2.IUnknown
obj, objMgr, port
 
Constructor Summary
IRuntimeErrorEvent(java.lang.String wrapped, org.virtualbox_5_2.ObjectRefManager objMgr, org.virtualbox_5_2.jaxws.VboxPortType port)
           
 
Method Summary
 java.lang.Boolean getFatal()
          Whether the error is fatal or not.
 java.lang.String getId()
          Error identifier.
 java.lang.String getMessage()
          Optional error message.
static IRuntimeErrorEvent queryInterface(IUnknown obj)
           
 
Methods inherited from class org.virtualbox_5_2.IEvent
getSource, getType, getWaitable, setProcessed, waitProcessed
 
Methods inherited from class org.virtualbox_5_2.IUnknown
getObjMgr, getRemoteWSPort, getWrapped, releaseRemote
 
Methods inherited from class java.lang.Object
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait
 

Constructor Detail

IRuntimeErrorEvent

public IRuntimeErrorEvent(java.lang.String wrapped,
                          org.virtualbox_5_2.ObjectRefManager objMgr,
                          org.virtualbox_5_2.jaxws.VboxPortType port)
Method Detail

getFatal

public java.lang.Boolean getFatal()
Whether the error is fatal or not.

Returns:
Boolean

getId

public java.lang.String getId()
Error identifier.

Returns:
String

getMessage

public java.lang.String getMessage()
Optional error message.

Returns:
String

queryInterface

public static IRuntimeErrorEvent queryInterface(IUnknown obj)