org.virtualbox_5_1
Class IManagedObjectRef
java.lang.Object
org.virtualbox_5_1.IUnknown
org.virtualbox_5_1.IManagedObjectRef
public class IManagedObjectRef
- extends IUnknown
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 torelease()
or by logging off from
the webservice (IWebsessionManager.logoff(org.virtualbox_5_1.IVirtualBox)
), 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.
Interface ID: {9474D09D-2313-46DE-B568-A42B8718E8ED}
Constructor Summary |
IManagedObjectRef(java.lang.String wrapped,
org.virtualbox_5_1.ObjectRefManager objMgr,
org.virtualbox_5_1.jaxws.VboxPortType port)
|
Method Summary |
java.lang.String |
getInterfaceName()
Returns the name of the interface that this managed object represents,
for example, "IMachine", as a string. |
static IManagedObjectRef |
queryInterface(IUnknown obj)
|
void |
release()
Releases this managed object reference and frees the resources that
were allocated for it in the webservice server process. |
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
IManagedObjectRef
public IManagedObjectRef(java.lang.String wrapped,
org.virtualbox_5_1.ObjectRefManager objMgr,
org.virtualbox_5_1.jaxws.VboxPortType port)
queryInterface
public static IManagedObjectRef queryInterface(IUnknown obj)
getInterfaceName
public java.lang.String getInterfaceName()
- Returns the name of the interface that this managed object represents,
for example, "IMachine", as a string.
release
public void 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.