|
Syntax
- void mergeKey
(
- string aKeyName,
- string aUrl )
- raises ( com::sun::star::registry::InvalidRegistryException , com::sun::star::registry::MergeConflictException );
Description
connects the registry to a persistent data source represented by
an URL.
If a local registry is already open, this function
will close the currently open registry.
Parameter aURL
-
specifies the complete URL to access the data source.
Parameter bReadOnly
-
specifies if the data source should be opened for
read only.
Parameter bCreate
- <
specifies if the data source should be created if it
does not already exist.
@throws InvalidRegistryException
if the registry does not exist.
*/
void open( [in] string rURL,
[in] boolean bReadOnly,
[in] boolean bCreate )
raises( com::sun::star::registry::InvalidRegistryException );
//-------------------------------------------------------------------------
/** checks if the registry points to a valid data-source.
*/
boolean isValid();
//-------------------------------------------------------------------------
/** disconnects the registry from the data-source.
@throws InvalidRegistryException
if the registry is not open.
*/
void close()
raises( com::sun::star::registry::InvalidRegistryException );
//-------------------------------------------------------------------------
/** destroys the registry and the data source.
@throws InvalidRegistryException
if the registry is not open.
*/
void destroy()
raises( com::sun::star::registry::InvalidRegistryException );
//-------------------------------------------------------------------------
/** @returns
the root key of the registry.
@throws InvalidRegistryException
if no registry is open
*/
com::sun::star::registry::XRegistryKey getRootKey()
raises( com::sun::star::registry::InvalidRegistryException );
//-------------------------------------------------------------------------
/** checks if the registry is readonly.
@throws InvalidRegistryException
if the registry is not open.
*/
boolean isReadOnly()
raises( com::sun::star::registry::InvalidRegistryException );
//-------------------------------------------------------------------------
/** merges a registry under the specified key.
If the key does not exist it will be created. Existing
keys will be overridden from keys of registry specified by
aUrl .
Throws
- InvalidRegistryException
if the registry is not open.
Throws
- MergeConflictException
if any differences occur during merging
|