createRegistryKey        package:SWinRegistry        R Documentation

_M_a_n_a_g_e _R_e_g_i_s_t_r_y _K_e_y_s

_D_e_s_c_r_i_p_t_i_o_n:

     These functions allow one to manage the set of keys in a part of
     the registry.  One can create and delete a key. Also,
     'flushRegistryKey' can be used to force any changes to be
     immediately reflected in the registry.

_U_s_a_g_e:

     createRegistryKey(path, key = character(0), top = .BuiltinKeys[1], recursive = FALSE, check = TRUE)
     deleteRegistryKey(path, key, top = .BuiltinKeys[1], asKey = FALSE, recursive = FALSE, resolve = TRUE)
     flushRegistryKey(path, top = .BuiltinKeys[1])

_A_r_g_u_m_e_n_t_s:

    path: the hierarchical path in the registry that is combined with
          'top' to identify the folder containing the key of interest.

     key: the name of a key within a folder within the registry.

     top: if specified, the name of a top-level key in the registry
          which is combined with path to identify the folder in which
          the key of interest is to be found 

   check: a logical value indicating whether we should check whether
          the key exists or not before attempting to create it. If 
          'TRUE' and the key exists, we simply return the path.  If the
          key exists but is merely a value and not a regular key that
          can support sub-keys, we raise an error.

   asKey: a logical value which, if 'TRUE' removes the key and which if
          'FALSE' removes the value of the key.

recursive: a logical value which is currently ignored.  If this is
          activated, it would allow one to remove a folder that
          contains other keys.

 resolve: a logical value indicating whether to check whether the key
          exists and whether it is a value or a key.

_V_a_l_u_e:

createRegistryKey: A logical value indicating whether the key was
          created or not. If the key already existed, this is 'FALSE'.
          If the key was created anew, this is 'TRUE'. 

deleteRegistryKey: A logical value which is 'TRUE' or else an error is
          thrown. 

flushRegistryKey: 

     { A logical value which is 'TRUE' or else an error is thrown. }

_A_u_t_h_o_r(_s):

     Duncan Temple Lang <duncan@wald.ucdavis.edu>

_R_e_f_e_r_e_n_c_e_s:

     <URL: http://www.omegahat.org/SWinRegistry>

_S_e_e _A_l_s_o:

     'getRegistryValue' 'setRegistryValue'

     '.resolveToplevelRegistryKey' 'regedit.exe'

