IExtPackManager Interface Reference

Interface for managing VirtualBox Extension Packs. More...

List of all members.

Public Member Functions

void find (in wstring name,[retval] out IExtPack returnData)
 Returns the extension pack with the specified name if found.
void openExtPackFile (in wstring path,[retval] out IExtPackFile file)
 Attempts to open an extension pack file in preparation for installation.
void install (in wstring path,[retval] out wstring name)
 Please use openExtPackFile + IExtPackFile::install instead of this interface.
void uninstall (in wstring name, in boolean forcedRemoval)
 Uninstalls an extension pack, removing all related files.
void cleanup ()
 Cleans up failed installs and uninstalls.
void QueryAllPlugInsForFrontend (in wstring frontendName,[retval] out wstring[] plugInModules)
 Gets the path to all the plug-in modules for a given frontend.

Public Attributes

readonly attribute IExtPack[] installedExtPacks
 List of the installed extension packs.


Detailed Description

Interface for managing VirtualBox Extension Packs.

TODO: Describe extension packs, how they are managed and how to create one.

Interface ID:
{8104DF65-74D6-4E33-B374-50AA062B4AFD}

Member Function Documentation

void IExtPackManager::find ( in wstring  name,
[retval] out IExtPack  returnData 
)

Returns the extension pack with the specified name if found.

Parameters:
name The name of the extension pack to locate.
returnData The extension pack if found.
Expected result codes:
VBOX_E_OBJECT_NOT_FOUND No extension pack matching name was found.

void IExtPackManager::openExtPackFile ( in wstring  path,
[retval] out IExtPackFile  file 
)

Attempts to open an extension pack file in preparation for installation.

Parameters:
path The path of the extension pack tarball.
file The interface of the extension pack file object.

void IExtPackManager::install ( in wstring  path,
[retval] out wstring  name 
)

Please use openExtPackFile + IExtPackFile::install instead of this interface.

This will be removed later in the beta cycle.

Parameters:
path The path of the extension pack tarball.
name The name of the installed extension pack.

void IExtPackManager::uninstall ( in wstring  name,
in boolean  forcedRemoval 
)

Uninstalls an extension pack, removing all related files.

Parameters:
name The name of the extension pack to uninstall.
forcedRemoval Forced removal of the extension pack. This means that the uninstall hook will not be called.

void IExtPackManager::cleanup (  ) 

Cleans up failed installs and uninstalls.

void IExtPackManager::QueryAllPlugInsForFrontend ( in wstring  frontendName,
[retval] out wstring[]  plugInModules 
)

Gets the path to all the plug-in modules for a given frontend.

This is a convenience method that is intended to simplify the plug-in loading process for a frontend.

Parameters:
frontendName The name of the frontend or component.
plugInModules Array containing the plug-in modules (full paths).


Member Data Documentation

List of the installed extension packs.


Generated on Mon Dec 6 19:35:24 2010 for VirtualBox Main API by  doxygen 1.5.6