Public Member Functions | Public Attributes

IVirtualBoxClient Interface Reference

Convenience interface for client applications. More...

List of all members.

Public Member Functions

void checkMachineError (in IMachine machine)
 Perform error checking before using an IMachine object.

Public Attributes

readonly attribute IVirtualBox virtualBox
 Reference to the server-side API root object.
readonly attribute ISession session
 Create a new session object and return the reference to it.
readonly attribute IEventSource eventSource
 Event source for VirtualBoxClient events.

Detailed Description

Convenience interface for client applications.

Treat this as a singleton, i.e. never create more than one instance of this interface.

At the moment only available for clients of the local API (not usable via the webservice). Once the session logic is redesigned this might change.

Interface ID:
{D191281F-B0CB-4D83-A8FA-0D9FD6BA234C}

Member Function Documentation

void IVirtualBoxClient::checkMachineError ( in IMachine  machine  ) 

Perform error checking before using an IMachine object.

Generally useful before starting a VM and all other uses. If anything is not as it should be then this method will return an appropriate error.

Parameters:
machine The machine object to check.

Member Data Documentation

Reference to the server-side API root object.

Create a new session object and return the reference to it.

Event source for VirtualBoxClient events.