All Manuals > LispWorks® User Guide and Reference Manual > 49 The Windows registry API

registry-key-exists-p Function

Summary

The predicate for whether a registry key can be opened.

Package

win32

Signature

registry-key-exists-p subkey &key root access => existsp

Arguments
subkey
A string specifying the name of the key.
root
A keyword or handle.
access
An integer or keyword.
Values
existsp
A boolean.
Description

The function registry-key-exists-p checks whether the registry key named subkey can be opened under the parent key root with the supplied access permissions.

subkey and root are interpreted as described for create-registry-key. The default value of root is :user.

If access is :read, then it opens the key with KEY_READ permissions. If access is :write, then it opens the key with KEY_WRITE permissions. If access is an integer, then the value access specifies the desired Win32 access rights. If access is omitted and root is :user, then registry-key-exists-p uses KEY_ALL_ACCESS. Otherwise it uses KEY_READ.

registry-key-exists-p closes the key before returning, but the return value is t if the key could actually be opened and nil otherwise.

See also

create-registry-key


LispWorks® User Guide and Reference Manual - 01 Dec 2021 19:31:09