REGCP$HELP.HLB  —  MODIFY  TREE
    Modifies the information for the specified key and its subkeys.

                                 CAUTION

       Modifying a tree results in symbolic links not being
       followed. This is because the key and subkeys you specify
       are modified, not the key pointed to by the symbolic link.

    This command requires the SYSPRV privilege or the REG$UPDATE
    rights identifier.

    Format:

      MODIFY TREE  key-name

    key-name

    Specifies the name of key to modify.

1  –  Qualifiers

1.1    /CACHE_ACTION

    /CACHE_ACTION=value

    Specifies the cache attribute for the key and its subkeys. The
    value can be WRITEBEHIND (write to disk later) or WRITETHRU
    (write to disk immediately).

1.2    /CLASS_NAME

    /CLASS_NAME=string

    Specifies the new class name for the given key and all its
    subkeys.

1.3    /SECPOLICY

    /SECPOLICY=policy

    Defines the security policy for the key. Currently the only valid
    policy is NT_40.

1.4    /WAIT

    /WAIT=seconds (default = 90)
    /NOWAIT

    Specifies the maximum amount of time, in seconds, that you are
    willing to wait for command completion.  If the Registry server
    does not complete the request in the specified interval, REG$CP
    returns REG-F-NORESPONSE. The default interval is 90 seconds.
    /NOWAIT is equivalent to specifying /WAIT=0, but there may still
    be a short wait period.

1.5    /WRITEBEHIND

    /WRITEBEHIND
    /NOWRITEBEHIND (default)

    Specifies when the information can be written to disk.
    /WRITEBEHIND specifies that the information can be written to
    disk later. /NOWRITEBEHIND specifies write-through operation
    (that is, the information must be written to disk immediately).

2  –  Example

        REG> MODIFY TREE/CACHE_ACTION=WRITEBEHIND HKEY_USERS\GUEST

      Modifies the cache attribute of the GUEST key and all its
      subkeys.
Close Help