interface XSimpleRegistry in module com::sun::star::registry::

(Global Index)

Syntax

interface XSimpleRegistry : com::sun::star::uno::XInterface ;

Description

Method Summary

mergeKey connects the registry to a persistent data source represented by an URL.

Method Details



mergeKey

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
Top of Page