registry-value

registry-value Accessor

Summary

Gets or sets a value in the registry.

Package

win32

Signatures

registry-value subkey name &key root expected-type errorp => data, successp, error-code

setf (registry-value subkey name &key root expected-type errorp) data => data

Arguments

`subkey`⇩	A string specifying the name of the key.
`name`⇩	A string specifying the name of the value.
`root`⇩	A keyword or handle.
`expected-type`⇩	A keyword or `t`.
`errorp`⇩	A boolean.
`data`⇩	A Lisp object.

Values

`data`	A Lisp object.
`successp`	A boolean.
`error-code`⇩	An integer error code or `nil`.

Description

The accessor registry-value gets and sets the value associated with name in subkey under the key root.

subkey and root are interpreted as described for create-registry-key. The default value of root is :user.

If the value exists, then the return values are the data and true. expected-type controls how certain types are converted to Lisp objects as described for enum-registry-value. The default value of expected-type is t.

If an error occurs and errorp is true then an error is signaled. Otherwise, the return values are nil, nil and the Windows error-code. The default value of errorp is t.

The function (setf registry-value) sets data as the value associated with name in subkey under the key root, creating the subkey if necessary. The default value of root is :user.