org.virtualbox_4_2
Class ISharedFolder
java.lang.Object
org.virtualbox_4_2.ISharedFolder
public class ISharedFolder
- extends java.lang.Object
The ISharedFolder interface represents a folder in the host computer's
file system accessible from the guest OS running inside a virtual
machine using an associated logical name.
There are three types of shared folders:
- Global (
IVirtualBox.getSharedFolders()
), shared
folders available to all virtual machines. - Permanent (
IMachine.getSharedFolders()
),
VM-specific shared folders available to the given virtual machine at
startup. - Transient (
IConsole.getSharedFolders()
),
VM-specific shared folders created in the session context (for
example, when the virtual machine is running) and automatically
discarded when the session is closed (the VM is powered off).
Logical names of shared folders must be unique within the given scope
(global, permanent or transient). However, they do not need to be unique
across scopes. In this case, the definition of the shared folder in a
more specific scope takes precedence over definitions in all other
scopes. The order of precedence is (more specific to more general):
- Transient definitions
- Permanent definitions
- Global definitions
For example, if MyMachine has a shared folder named
C_DRIVE (that points to C:\\), then creating a
transient shared folder named C_DRIVE (that points
to C:\\\\WINDOWS) will change the definition
of C_DRIVE in the guest OS so
that \\\\VBOXSVR\\C_DRIVE will give access
to C:\\WINDOWS instead of C:\\ on the host
PC. Removing the transient shared folder C_DRIVE will restore
the previous (permanent) definition of C_DRIVE that points
to C:\\ if it still exists.
Note that permanent and transient shared folders of different machines
are in different name spaces, so they don't overlap and don't need to
have unique logical names.
NOTE:
Global shared folders are not implemented in the current version of the
product.
Interface ID: {8388DA11-B559-4574-A5B7-2BD7ACD5CEF8}
Constructor Summary |
ISharedFolder(org.virtualbox_4_2.jaxws.ISharedFolder real,
org.virtualbox_4_2.jaxws.VboxPortType port)
|
Methods inherited from class java.lang.Object |
clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait |
ISharedFolder
public ISharedFolder(org.virtualbox_4_2.jaxws.ISharedFolder real,
org.virtualbox_4_2.jaxws.VboxPortType port)
getName
public java.lang.String getName()
getHostPath
public java.lang.String getHostPath()
getAccessible
public java.lang.Boolean getAccessible()
getWritable
public java.lang.Boolean getWritable()
getAutoMount
public java.lang.Boolean getAutoMount()
getLastAccessError
public java.lang.String getLastAccessError()