query-registry-value

query-registry-value 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 key for root 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.