Download Oracle VM VirtualBox Programming Guide and Reference

5 Classes (interfaces)
5.58 IMachineStateChangedEvent (IMachineEvent)
Note: This interface extends IMachineEvent and therefore supports all its methods and
attributes as well.
Machine state change event.
5.58.1 Attributes
5.58.1.1 state (read-only)
MachineState IMachineStateChangedEvent::state
New execution state.
5.59 IManagedObjectRef
Note: This interface is supported in the web service only, not in COM/XPCOM.
Managed object reference.
Only within the webservice, a managed object reference (which is really an opaque number)
allows a webservice client to address an object that lives in the address space of the webservice
server.
Behind each managed object reference, there is a COM object that lives in the webservice server’s address space. The COM object is not freed until the managed object reference is released, either by an explicit call to release() or by logging off from the webservice
(IWebsessionManager::logoff()), which releases all objects created during the webservice session.
Whenever a method call of the VirtualBox API returns a COM object, the webservice representation of that method will instead return a managed object reference, which can then be used to
invoke methods on that object.
5.59.1 getInterfaceName
wstring IManagedObjectRef::getInterfaceName()
Returns the name of the interface that this managed object represents, for example, “IMachine”, as a string.
5.59.2 release
void IManagedObjectRef::release()
Releases this managed object reference and frees the resources that were allocated for it in the
webservice server process. After calling this method, the identifier of the reference can no longer
be used.
192