registry-write


Synopsis

(registry-write <path> <key> <value>)

Description

Sets a new registry value for the given unique Windows registry key.

Example

(registry-write 
(strcat "HKEY_CURRENT_USER\\" (registry-acad-product-key)
"\\Profiles")
"" "myprofile") => "myprofile"

Valid <path> string arguments for every registry-xxx function should start with one of the following strings:

HKEY_CLASSES_ROOT
HKEY_CURRENT_USER
HKEY_LOCAL_MACHINE
HKEY_USERS
HKEY_CURRENT_CONFIG

registry-write is the same as the according Vital Lisp 3 function (vlx-registry-write) and the undocumented Visual Lisp function (vl-registry-write) - but without optional arguments.

Note: For safety reasons the Visual Lisp function (vl-registry-write) is not expanded by Ctrl-Space.

The default key of a subtree may be given with just the name of the subtree (as in the example above) of with the string "@" as in

(registry-set (strcat "HKEY_CURRENT_USER\\" (registry-acad-product-key) "\\Profiles") "@" "myprofile")

It is used by (register-VL-app) in SAMPLES\REGARX.LSP to provide arx demand-loading for your application.

Note

Carefully check the correct keys and values as this function easily can damage a user's Windows environment!

The Windows registry is a central OS database which is easily and fast accessed, but it's hard to copy entries to other systems.

Arguments

path: A string naming the specific registry subtree. Case-dependant

key: A string naming the specific key in the registry path. The key does not need to exist. Case-dependant

value: A string or a number.

Return Value

The new value of the found key, NIL otherwise.

Side Effects

None, besides changing the windows registry.

Module

(std-require 'REGISTRY)

Defined in REGISTRY