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