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 signalled. 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