/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */ /* * This file is part of the LibreOffice project. * * This Source Code Form is subject to the terms of the Mozilla Public * License, v. 2.0. If a copy of the MPL was not distributed with this * file, You can obtain one at http://mozilla.org/MPL/2.0/. * * This file incorporates work covered by the following license notice: * * Licensed to the Apache Software Foundation (ASF) under one or more * contributor license agreements. See the NOTICE file distributed * with this work for additional information regarding copyright * ownership. The ASF licenses this file to you under the Apache * License, Version 2.0 (the "License"); you may not use this file * except in compliance with the License. You may obtain a copy of * the License at http://www.apache.org/licenses/LICENSE-2.0 . */ #ifndef __com_sun_star_registry_NestedRegistry_idl__ #define __com_sun_star_registry_NestedRegistry_idl__ #include #include module com { module sun { module star { module registry { /** supports a shared view on two different registries. The registry files will be opened in two different modes, registry1 will be opened with read/write rights and registry2 will be opened read-only. In the context of this service, the functions open, close, and destroy from XSimpleRegistry are not supported and throw an exception if they are used. Functions of XSimpleRegistry:
getURL
returns the name of registry1.
isValid
checks if registry1 is valid. If the interface is not `NULL` then registry1 should always be valid.
isReadOnly
checks if registry1 has write protection.
mergeKey
merges all information from the specified registry in registry1.
getRootKey
returns a virtual rootkey of both registries.
Functions of XRegistryKey:
openKey
returns a virtual key which is specified in registry1 or registry2.
deleteKey
deletes the key only if it is present in registry1.
setLongValue, setAsciiValue, setStringValue, setBinaryValue
sets the value at the specified key in registry1.
getLongValue, getAsciiValue, getStringValue, getBinaryValue
returns the value at the specified key in registry1, or if the value is not present in registry1, it will return the value of registry2.
openKeys
returns a sequence of all subkeys in both registries.
getKeyNames
returns a sequence with the names of all subkeys in both registries.
Note: all write functions only work on registry1.
How to initialize the registries:
Use a sequence of XSimpleRegistry with two elements. The first element must be the registry which is opened with read/write rights and the second element must be the read-only one.
Two different ways are possible:

Guarantees: */ published service NestedRegistry { interface com::sun::star::registry::XSimpleRegistry; interface com::sun::star::lang::XInitialization; }; }; }; }; }; #endif /* vim:set shiftwidth=4 softtabstop=4 expandtab: */