create-registry-key subkey &key class root access errorp => handle , disposition , error-code
A string specifying the name of the key.
A string.
A keyword or handle.
A keyword or an integer.
A generalized boolean.
The handle of the new key.
A keyword, either
:created-new-key
or
:opened-existing-key
.
An integer error code or
nil
.
The function
create-registry-key
creates a new registry key named
subkey
under the parent key
root
. If the key already exists, it is opened and returned.
subkey
is a string specifying a path from a root. Each component of the path is separated by a backslash. Use
""
to denote the null path (that is, the root).
class can be used to specify the class of the key if it is created.
root
should be a handle to an open registry key (for example a key returned by
create-registry-key
or open-registry-key or one of the keywords
:classes
,
:user
,
:local-machine
or
:users
which represent the standard top level roots in the registry. The default value of
root
is
:user
.
If
access
is
:read
, then the key is created with
KEY_READ
permissions. If
access
is
:write
, then the key is created with
KEY_WRITE
permissions. If
access
is an integer, then the value
access
specifies the desired Win32 access rights. The default value of
access
is
:read
.
The return values on success are the handle of the new key and a keyword
:created-new-key
or
:opened-existing-key
indicating whether a new key was created or opened.
If an error occurs and
errorp
is true then an error is signalled. Otherwise, the return values are
nil
,
nil
and the Windows
error-code
. The default value of
errorp
is
t
.