REGCP$HELP.HLB  —  MODIFY  KEY
    Modifies the attributes of the specified key.

                                 CAUTION

       Modifying a key results in symbolic links not being
       followed. This is because the system modifies the key you
       specified, not the key pointed to by the symbolic link.

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

    Format:

      MODIFY KEY  key-name

    key-name

    Specifies the name of the key to modify.

1  –  Qualifiers

1.1    /CACHE_ACTION 

    /CACHE_ACTION=value

    Specifies the cache attribute for the key. 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 of the key.

1.3    /LINK 

    /LINK=(TYPE=value, NAME=key-name)

    Defines the key as a link to another key. The link value must be
    one of the following:

      o  SYMBOLICLINK

      o  NONE

    To remove a link, enter the following:

    /LINK=(TYPE=NONE,NAME="")

1.4    /NEW_NAME 

    /NEW_NAME=new-key-name

    Specifies the new name of the key.

1.5    /SECPOLICY 

    /SECPOLICY=policy

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

1.6    /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.7    /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 KEY/CACHE_ACTION=WRITEBEHIND HKEY_USERS\GUEST

      Modifies the cache attribute of the GUEST key.
Close Help