Function

Summary

Returns a value stored in the registry.

Package

win32

Signature

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

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 query-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. If subkey is an empty string, then the root key is returned. 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 the Lisp object data 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 .

See also

create-registry-key
enum-registry-value