1*cdf0e10cSrcweir/************************************************************************* 2*cdf0e10cSrcweir * 3*cdf0e10cSrcweir * DO NOT ALTER OR REMOVE COPYRIGHT NOTICES OR THIS FILE HEADER. 4*cdf0e10cSrcweir * 5*cdf0e10cSrcweir * Copyright 2000, 2010 Oracle and/or its affiliates. 6*cdf0e10cSrcweir * 7*cdf0e10cSrcweir * OpenOffice.org - a multi-platform office productivity suite 8*cdf0e10cSrcweir * 9*cdf0e10cSrcweir * This file is part of OpenOffice.org. 10*cdf0e10cSrcweir * 11*cdf0e10cSrcweir * OpenOffice.org is free software: you can redistribute it and/or modify 12*cdf0e10cSrcweir * it under the terms of the GNU Lesser General Public License version 3 13*cdf0e10cSrcweir * only, as published by the Free Software Foundation. 14*cdf0e10cSrcweir * 15*cdf0e10cSrcweir * OpenOffice.org is distributed in the hope that it will be useful, 16*cdf0e10cSrcweir * but WITHOUT ANY WARRANTY; without even the implied warranty of 17*cdf0e10cSrcweir * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the 18*cdf0e10cSrcweir * GNU Lesser General Public License version 3 for more details 19*cdf0e10cSrcweir * (a copy is included in the LICENSE file that accompanied this code). 20*cdf0e10cSrcweir * 21*cdf0e10cSrcweir * You should have received a copy of the GNU Lesser General Public License 22*cdf0e10cSrcweir * version 3 along with OpenOffice.org. If not, see 23*cdf0e10cSrcweir * <http://www.openoffice.org/license.html> 24*cdf0e10cSrcweir * for a copy of the LGPLv3 License. 25*cdf0e10cSrcweir * 26*cdf0e10cSrcweir ************************************************************************/ 27*cdf0e10cSrcweir#ifndef __com_sun_star_registry_XRegistryKey_idl__ 28*cdf0e10cSrcweir#define __com_sun_star_registry_XRegistryKey_idl__ 29*cdf0e10cSrcweir 30*cdf0e10cSrcweir#ifndef __com_sun_star_uno_XInterface_idl__ 31*cdf0e10cSrcweir#include <com/sun/star/uno/XInterface.idl> 32*cdf0e10cSrcweir#endif 33*cdf0e10cSrcweir 34*cdf0e10cSrcweir#ifndef __com_sun_star_registry_InvalidRegistryException_idl__ 35*cdf0e10cSrcweir#include <com/sun/star/registry/InvalidRegistryException.idl> 36*cdf0e10cSrcweir#endif 37*cdf0e10cSrcweir 38*cdf0e10cSrcweir#ifndef __com_sun_star_registry_RegistryKeyType_idl__ 39*cdf0e10cSrcweir#include <com/sun/star/registry/RegistryKeyType.idl> 40*cdf0e10cSrcweir#endif 41*cdf0e10cSrcweir 42*cdf0e10cSrcweir#ifndef __com_sun_star_registry_RegistryValueType_idl__ 43*cdf0e10cSrcweir#include <com/sun/star/registry/RegistryValueType.idl> 44*cdf0e10cSrcweir#endif 45*cdf0e10cSrcweir 46*cdf0e10cSrcweir#ifndef __com_sun_star_registry_InvalidValueException_idl__ 47*cdf0e10cSrcweir#include <com/sun/star/registry/InvalidValueException.idl> 48*cdf0e10cSrcweir#endif 49*cdf0e10cSrcweir 50*cdf0e10cSrcweir 51*cdf0e10cSrcweir//============================================================================= 52*cdf0e10cSrcweir 53*cdf0e10cSrcweirmodule com { module sun { module star { module registry { 54*cdf0e10cSrcweir 55*cdf0e10cSrcweir//============================================================================= 56*cdf0e10cSrcweir/** makes structural information (except regarding tree structures) 57*cdf0e10cSrcweir of a single registry key accessible. 58*cdf0e10cSrcweir 59*cdf0e10cSrcweir <p>This is the main interface for registry keys.<p> 60*cdf0e10cSrcweir 61*cdf0e10cSrcweir @see XSimpleRegistry 62*cdf0e10cSrcweir*/ 63*cdf0e10cSrcweirpublished interface XRegistryKey: com::sun::star::uno::XInterface 64*cdf0e10cSrcweir{ 65*cdf0e10cSrcweir //--------------------------------------------------------------------- 66*cdf0e10cSrcweir /** This is the key of the entry relative to its parent.<p> 67*cdf0e10cSrcweir 68*cdf0e10cSrcweir <p>The access path starts with the root "/" and all parent 69*cdf0e10cSrcweir entry names are delimited with slashes "/" too, like in a 70*cdf0e10cSrcweir UNIX (R) file system. Slashes which are part of single names 71*cdf0e10cSrcweir are represented as hexadecimals preceded with a "%" like in 72*cdf0e10cSrcweir URL syntax. 73*cdf0e10cSrcweir */ 74*cdf0e10cSrcweir [readonly, attribute] string KeyName; 75*cdf0e10cSrcweir 76*cdf0e10cSrcweir //------------------------------------------------------------------------- 77*cdf0e10cSrcweir /** checks if the key can be overwritten. 78*cdf0e10cSrcweir 79*cdf0e10cSrcweir @throws InvalidRegistryException 80*cdf0e10cSrcweir if the registry is not open. 81*cdf0e10cSrcweir */ 82*cdf0e10cSrcweir boolean isReadOnly() 83*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 84*cdf0e10cSrcweir 85*cdf0e10cSrcweir //------------------------------------------------------------------------- 86*cdf0e10cSrcweir /** checks if the key points to an open valid key in the data-source. 87*cdf0e10cSrcweir */ 88*cdf0e10cSrcweir boolean isValid(); 89*cdf0e10cSrcweir 90*cdf0e10cSrcweir //------------------------------------------------------------------------- 91*cdf0e10cSrcweir /** @returns 92*cdf0e10cSrcweir the type of the specified key. 93*cdf0e10cSrcweir 94*cdf0e10cSrcweir @param rKeyName 95*cdf0e10cSrcweir specifies the relative path from the current key to 96*cdf0e10cSrcweir the key of the type which will be returned. 97*cdf0e10cSrcweir 98*cdf0e10cSrcweir @throws InvalidRegistryException 99*cdf0e10cSrcweir if the registry is not open. 100*cdf0e10cSrcweir */ 101*cdf0e10cSrcweir com::sun::star::registry::RegistryKeyType getKeyType( [in] string rKeyName ) 102*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 103*cdf0e10cSrcweir 104*cdf0e10cSrcweir //------------------------------------------------------------------------- 105*cdf0e10cSrcweir /** @returns 106*cdf0e10cSrcweir the type of the key value or NOT_DEFINED if the key has no value. 107*cdf0e10cSrcweir 108*cdf0e10cSrcweir @throws InvalidRegistryException 109*cdf0e10cSrcweir if the registry is not open. 110*cdf0e10cSrcweir */ 111*cdf0e10cSrcweir com::sun::star::registry::RegistryValueType getValueType() 112*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 113*cdf0e10cSrcweir 114*cdf0e10cSrcweir //------------------------------------------------------------------------- 115*cdf0e10cSrcweir /** @returns 116*cdf0e10cSrcweir a long value if the key contains one. 117*cdf0e10cSrcweir 118*cdf0e10cSrcweir @throws InvalidRegistryException 119*cdf0e10cSrcweir if the registry is not open. 120*cdf0e10cSrcweir 121*cdf0e10cSrcweir @throws InvalidValueException 122*cdf0e10cSrcweir if the value is not of type long. 123*cdf0e10cSrcweir */ 124*cdf0e10cSrcweir long getLongValue() 125*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 126*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 127*cdf0e10cSrcweir 128*cdf0e10cSrcweir //------------------------------------------------------------------------- 129*cdf0e10cSrcweir /** sets a long value to the key. 130*cdf0e10cSrcweir 131*cdf0e10cSrcweir <p>If the key already has a value, the value will be 132*cdf0e10cSrcweir overridden. 133*cdf0e10cSrcweir 134*cdf0e10cSrcweir @throws InvalidRegistryException 135*cdf0e10cSrcweir if the registry is not open. 136*cdf0e10cSrcweir */ 137*cdf0e10cSrcweir void setLongValue( [in] long value ) 138*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 139*cdf0e10cSrcweir 140*cdf0e10cSrcweir //------------------------------------------------------------------------- 141*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getLongListValue 142*cdf0e10cSrcweir /** @returns 143*cdf0e10cSrcweir a sequence of longs if the key contains a long list value. 144*cdf0e10cSrcweir 145*cdf0e10cSrcweir @throws InvalidRegistryException 146*cdf0e10cSrcweir if the registry is not open. 147*cdf0e10cSrcweir 148*cdf0e10cSrcweir @throws InvalidValueException 149*cdf0e10cSrcweir if the actual value is not of type long list. 150*cdf0e10cSrcweir */ 151*cdf0e10cSrcweir sequence<long> getLongListValue() 152*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 153*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 154*cdf0e10cSrcweir 155*cdf0e10cSrcweir //------------------------------------------------------------------------- 156*cdf0e10cSrcweir /** sets a long list value to the key. 157*cdf0e10cSrcweir 158*cdf0e10cSrcweir <p>If the key already has a value, the value will be 159*cdf0e10cSrcweir overridden. 160*cdf0e10cSrcweir 161*cdf0e10cSrcweir @throws InvalidRegistryException 162*cdf0e10cSrcweir if the registry is not open. 163*cdf0e10cSrcweir */ 164*cdf0e10cSrcweir void setLongListValue( [in] sequence<long> seqValue ) 165*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 166*cdf0e10cSrcweir 167*cdf0e10cSrcweir //------------------------------------------------------------------------- 168*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getAsciiValue 169*cdf0e10cSrcweir /** @returns 170*cdf0e10cSrcweir an ascii string value if the key contains one. 171*cdf0e10cSrcweir 172*cdf0e10cSrcweir @throws InvalidRegistryException 173*cdf0e10cSrcweir if the registry is not open. 174*cdf0e10cSrcweir 175*cdf0e10cSrcweir @throws InvalidValueException 176*cdf0e10cSrcweir if the actual value is not of type ascii. 177*cdf0e10cSrcweir */ 178*cdf0e10cSrcweir string getAsciiValue() 179*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 180*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 181*cdf0e10cSrcweir 182*cdf0e10cSrcweir //------------------------------------------------------------------------- 183*cdf0e10cSrcweir /** sets an ASCII string value to the key. 184*cdf0e10cSrcweir 185*cdf0e10cSrcweir <p>The high byte of the string should be NULL. If not, there 186*cdf0e10cSrcweir is no guarantee that the string will be correctly transported. 187*cdf0e10cSrcweir If the key already has a value, the value will be overridden. 188*cdf0e10cSrcweir 189*cdf0e10cSrcweir @throws InvalidRegistryException 190*cdf0e10cSrcweir if the registry is not open. 191*cdf0e10cSrcweir */ 192*cdf0e10cSrcweir void setAsciiValue( [in] string value ) 193*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 194*cdf0e10cSrcweir 195*cdf0e10cSrcweir //------------------------------------------------------------------------- 196*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getAsciiListValue 197*cdf0e10cSrcweir /** @returns 198*cdf0e10cSrcweir a sequence of ascii strings if the key contains an asci list value. 199*cdf0e10cSrcweir 200*cdf0e10cSrcweir @throws InvalidRegistryException 201*cdf0e10cSrcweir if the registry is not open. 202*cdf0e10cSrcweir 203*cdf0e10cSrcweir @throws InvalidValueException 204*cdf0e10cSrcweir if the actual value is not of type ascii list. 205*cdf0e10cSrcweir */ 206*cdf0e10cSrcweir sequence<string> getAsciiListValue() 207*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 208*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 209*cdf0e10cSrcweir 210*cdf0e10cSrcweir //------------------------------------------------------------------------- 211*cdf0e10cSrcweir /** sets an ASCII string list value to the key. 212*cdf0e10cSrcweir 213*cdf0e10cSrcweir <p>The high byte of the string should be NULL. If not, there 214*cdf0e10cSrcweir is no guarantee that the string will be correctly transported. 215*cdf0e10cSrcweir If the key already has a value, the value will be overridden. 216*cdf0e10cSrcweir 217*cdf0e10cSrcweir @throws InvalidRegistryException 218*cdf0e10cSrcweir if the registry is not open. 219*cdf0e10cSrcweir */ 220*cdf0e10cSrcweir void setAsciiListValue( [in] sequence<string> seqValue ) 221*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 222*cdf0e10cSrcweir 223*cdf0e10cSrcweir //------------------------------------------------------------------------- 224*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getStringValue 225*cdf0e10cSrcweir /** @returns 226*cdf0e10cSrcweir a unicode string value if the key contains one. 227*cdf0e10cSrcweir 228*cdf0e10cSrcweir @throws InvalidRegistryException 229*cdf0e10cSrcweir if the registry is not open. 230*cdf0e10cSrcweir 231*cdf0e10cSrcweir @throws InvalidValueException 232*cdf0e10cSrcweir if the actual value is not of type string. 233*cdf0e10cSrcweir */ 234*cdf0e10cSrcweir string getStringValue() 235*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 236*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 237*cdf0e10cSrcweir 238*cdf0e10cSrcweir //------------------------------------------------------------------------- 239*cdf0e10cSrcweir /** sets a unicode string value to the key. 240*cdf0e10cSrcweir 241*cdf0e10cSrcweir <p> If the key already has a value, the value will be 242*cdf0e10cSrcweir overridden. 243*cdf0e10cSrcweir 244*cdf0e10cSrcweir @throws InvalidRegistryException 245*cdf0e10cSrcweir if the registry is not open. 246*cdf0e10cSrcweir */ 247*cdf0e10cSrcweir void setStringValue( [in] string value ) 248*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 249*cdf0e10cSrcweir 250*cdf0e10cSrcweir //------------------------------------------------------------------------- 251*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getStringListValue 252*cdf0e10cSrcweir /** @returns 253*cdf0e10cSrcweir a sequence of unicode strings if the key contains an unicode string list value. 254*cdf0e10cSrcweir 255*cdf0e10cSrcweir @throws InvalidRegistryException 256*cdf0e10cSrcweir if the registry is not open. 257*cdf0e10cSrcweir 258*cdf0e10cSrcweir @throws InvalidValueException 259*cdf0e10cSrcweir if the actual value is not of type string list. 260*cdf0e10cSrcweir */ 261*cdf0e10cSrcweir sequence<string> getStringListValue() 262*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 263*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 264*cdf0e10cSrcweir 265*cdf0e10cSrcweir //------------------------------------------------------------------------- 266*cdf0e10cSrcweir /** sets a unicode string value to the key. 267*cdf0e10cSrcweir 268*cdf0e10cSrcweir <p>If the key already has a value, the value will be overridden. 269*cdf0e10cSrcweir 270*cdf0e10cSrcweir @throws InvalidRegistryException 271*cdf0e10cSrcweir if the registry is not open. 272*cdf0e10cSrcweir */ 273*cdf0e10cSrcweir void setStringListValue( [in] sequence<string> seqValue ) 274*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 275*cdf0e10cSrcweir 276*cdf0e10cSrcweir //------------------------------------------------------------------------- 277*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getBinaryValue 278*cdf0e10cSrcweir /** @returns 279*cdf0e10cSrcweir a binary value if the key contains one. 280*cdf0e10cSrcweir 281*cdf0e10cSrcweir @throws InvalidRegistryException 282*cdf0e10cSrcweir if the registry is not open. 283*cdf0e10cSrcweir 284*cdf0e10cSrcweir @throws InvalidValueException 285*cdf0e10cSrcweir if the actual value is not of type binary. 286*cdf0e10cSrcweir */ 287*cdf0e10cSrcweir sequence<byte> getBinaryValue() 288*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException, 289*cdf0e10cSrcweir com::sun::star::registry::InvalidValueException ); 290*cdf0e10cSrcweir 291*cdf0e10cSrcweir //------------------------------------------------------------------------- 292*cdf0e10cSrcweir /** sets a binary value to the key. 293*cdf0e10cSrcweir 294*cdf0e10cSrcweir <p>If the key already has a value, the value will be 295*cdf0e10cSrcweir overridden. 296*cdf0e10cSrcweir 297*cdf0e10cSrcweir @throws InvalidRegistryException 298*cdf0e10cSrcweir if the registry is not open. 299*cdf0e10cSrcweir */ 300*cdf0e10cSrcweir void setBinaryValue( [in] sequence<byte> value ) 301*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 302*cdf0e10cSrcweir 303*cdf0e10cSrcweir //------------------------------------------------------------------------- 304*cdf0e10cSrcweir /** opens a sub key of the key. 305*cdf0e10cSrcweir 306*cdf0e10cSrcweir <p>If the sub key does not exist, the function returns a 307*cdf0e10cSrcweir NULL-interface. 308*cdf0e10cSrcweir 309*cdf0e10cSrcweir @param aKeyName 310*cdf0e10cSrcweir the relative path from the current key to the key 311*cdf0e10cSrcweir which will be created. 312*cdf0e10cSrcweir 313*cdf0e10cSrcweir @returns 314*cdf0e10cSrcweir a NULL interface if the key does not exist. 315*cdf0e10cSrcweir 316*cdf0e10cSrcweir @throws InvalidRegistryException 317*cdf0e10cSrcweir if the registry is not open. 318*cdf0e10cSrcweir */ 319*cdf0e10cSrcweir com::sun::star::registry::XRegistryKey openKey( [in] string aKeyName ) 320*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 321*cdf0e10cSrcweir 322*cdf0e10cSrcweir //------------------------------------------------------------------------- 323*cdf0e10cSrcweir /** creates a new key in the registry.<p> 324*cdf0e10cSrcweir 325*cdf0e10cSrcweir <p>If the key already exists, the function will open the key. 326*cdf0e10cSrcweir 327*cdf0e10cSrcweir @param aKeyName 328*cdf0e10cSrcweir specifies the relative path from the current key to 329*cdf0e10cSrcweir the key which will be created. 330*cdf0e10cSrcweir 331*cdf0e10cSrcweir @returns 332*cdf0e10cSrcweir a NULL interface if the key could not be created. 333*cdf0e10cSrcweir 334*cdf0e10cSrcweir @throws InvalidRegistryException 335*cdf0e10cSrcweir if the registry is not open, the registry is readonly 336*cdf0e10cSrcweir or if the key exists and is of type LINK. 337*cdf0e10cSrcweir */ 338*cdf0e10cSrcweir com::sun::star::registry::XRegistryKey createKey( [in] string aKeyName ) 339*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 340*cdf0e10cSrcweir 341*cdf0e10cSrcweir //------------------------------------------------------------------------- 342*cdf0e10cSrcweir /** closes a key in the registry. 343*cdf0e10cSrcweir 344*cdf0e10cSrcweir @throws InvalidRegistryException 345*cdf0e10cSrcweir if the registry is not open. 346*cdf0e10cSrcweir */ 347*cdf0e10cSrcweir void closeKey() 348*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 349*cdf0e10cSrcweir 350*cdf0e10cSrcweir //------------------------------------------------------------------------- 351*cdf0e10cSrcweir /** deletes a key from the registry. 352*cdf0e10cSrcweir 353*cdf0e10cSrcweir @param aKeyName 354*cdf0e10cSrcweir specifies the relative path from the current key to 355*cdf0e10cSrcweir the key which will be deleted. 356*cdf0e10cSrcweir 357*cdf0e10cSrcweir @throws InvalidRegistryException 358*cdf0e10cSrcweir if the registry is not open, the registry is readonly, 359*cdf0e10cSrcweir the key does not exists or if the key is of type LINK. 360*cdf0e10cSrcweir */ 361*cdf0e10cSrcweir void deleteKey( [in] string rKeyName ) 362*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 363*cdf0e10cSrcweir 364*cdf0e10cSrcweir //------------------------------------------------------------------------- 365*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::openKeys 366*cdf0e10cSrcweir /** opens all subkeys of the key. If a subkey is a link, the link will be 367*cdf0e10cSrcweir resolved and the appropriate key will be opened. 368*cdf0e10cSrcweir 369*cdf0e10cSrcweir @returns 370*cdf0e10cSrcweir an empty sequence if the key has no subkeys. 371*cdf0e10cSrcweir 372*cdf0e10cSrcweir @throws InvalidRegistryException 373*cdf0e10cSrcweir if the registry is not open. 374*cdf0e10cSrcweir */ 375*cdf0e10cSrcweir sequence<com::sun::star::registry::XRegistryKey> openKeys() 376*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 377*cdf0e10cSrcweir 378*cdf0e10cSrcweir //------------------------------------------------------------------------- 379*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getKeyNames 380*cdf0e10cSrcweir /** @returns a sequence with the names of all subkeys of the key. 381*cdf0e10cSrcweir If the key has no subkeys, the function returns an empty sequence. If a subkey is 382*cdf0e10cSrcweir a link, the name of the link will be returned. 383*cdf0e10cSrcweir 384*cdf0e10cSrcweir @throws InvalidRegistryException 385*cdf0e10cSrcweir if the registry is not open. 386*cdf0e10cSrcweir */ 387*cdf0e10cSrcweir sequence<string> getKeyNames() 388*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 389*cdf0e10cSrcweir 390*cdf0e10cSrcweir //------------------------------------------------------------------------- 391*cdf0e10cSrcweir /** creates a new link in the registry. 392*cdf0e10cSrcweir 393*cdf0e10cSrcweir @returns 394*cdf0e10cSrcweir <TRUE/> if the link was created. If the link already 395*cdf0e10cSrcweir exists or the link target does not exist, the 396*cdf0e10cSrcweir function returns <FALSE/>. 397*cdf0e10cSrcweir 398*cdf0e10cSrcweir @param aLinkName 399*cdf0e10cSrcweir specifies the relative path from the current key to 400*cdf0e10cSrcweir the link which will be created. 401*cdf0e10cSrcweir 402*cdf0e10cSrcweir @param aLinkTarget 403*cdf0e10cSrcweir specifies the full path of the key which will be 404*cdf0e10cSrcweir referenced by the link. 405*cdf0e10cSrcweir 406*cdf0e10cSrcweir @throws InvalidRegistryException 407*cdf0e10cSrcweir if the registry is not open or the registry is 408*cdf0e10cSrcweir readonly. 409*cdf0e10cSrcweir 410*cdf0e10cSrcweir */ 411*cdf0e10cSrcweir boolean createLink( [in] string aLinkName, 412*cdf0e10cSrcweir [in] string aLinkTarget ) 413*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 414*cdf0e10cSrcweir 415*cdf0e10cSrcweir //------------------------------------------------------------------------- 416*cdf0e10cSrcweir /** deletes a link from the registry. 417*cdf0e10cSrcweir 418*cdf0e10cSrcweir @param aLinkName 419*cdf0e10cSrcweir specifies the relative path from the current key to 420*cdf0e10cSrcweir the link which will be deleted. 421*cdf0e10cSrcweir 422*cdf0e10cSrcweir @throws InvalidRegistryException 423*cdf0e10cSrcweir if the registry is not open, the registry is readonly, 424*cdf0e10cSrcweir or if the link does not exist. 425*cdf0e10cSrcweir */ 426*cdf0e10cSrcweir void deleteLink( [in] string rLinkName ) 427*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 428*cdf0e10cSrcweir 429*cdf0e10cSrcweir //------------------------------------------------------------------------- 430*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getLinkTarget 431*cdf0e10cSrcweir /** @returns 432*cdf0e10cSrcweir the target (complete path of a key) of the link specified by rLinkName. 433*cdf0e10cSrcweir 434*cdf0e10cSrcweir @param rLinKName 435*cdf0e10cSrcweir specifies the relative path from the current key to 436*cdf0e10cSrcweir the link which target will be returned. 437*cdf0e10cSrcweir 438*cdf0e10cSrcweir @throws InvalidRegistryException 439*cdf0e10cSrcweir if the registry is not open or the link does not exists. 440*cdf0e10cSrcweir */ 441*cdf0e10cSrcweir string getLinkTarget( [in] string rLinkName ) 442*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 443*cdf0e10cSrcweir 444*cdf0e10cSrcweir //------------------------------------------------------------------------- 445*cdf0e10cSrcweir // DOCUMENTATION CHANGED FOR XRegistryKey::getResolvedName 446*cdf0e10cSrcweir /** @returns 447*cdf0e10cSrcweir the resolved name of a key. The function resolve the complete name of the key. 448*cdf0e10cSrcweir If a link could not be resolved, the linktarget concatenated with the unresolved rest 449*cdf0e10cSrcweir of the name, will be returned. 450*cdf0e10cSrcweir 451*cdf0e10cSrcweir @param rKeyName 452*cdf0e10cSrcweir specifies a relative path from the current key which will be resolved from all links. 453*cdf0e10cSrcweir 454*cdf0e10cSrcweir @throws InvalidRegistryException 455*cdf0e10cSrcweir if the registry is not open or a recursion was detected. 456*cdf0e10cSrcweir */ 457*cdf0e10cSrcweir string getResolvedName( [in] string aKeyName ) 458*cdf0e10cSrcweir raises( com::sun::star::registry::InvalidRegistryException ); 459*cdf0e10cSrcweir 460*cdf0e10cSrcweir}; 461*cdf0e10cSrcweir 462*cdf0e10cSrcweir//============================================================================= 463*cdf0e10cSrcweir 464*cdf0e10cSrcweir}; }; }; }; 465*cdf0e10cSrcweir 466*cdf0e10cSrcweir#endif 467