Accessor

Summary

Gets or sets a value in the registry.

Package

win32

Signature

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

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

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.

Values

data

A Lisp object.

successp

A boolean.

error-code

An integer error code or nil.

Description

The function registry-value returns 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 the value associated with name in subkey under the key root, creating the subkey if necessary. The default value of root is :user.

See also

set-registry-value