<< winopen OS functions

winqueryreg


Read the Windows registry (Windows only).


Syntax


c = winqueryreg ('name', rootkey, subkey)
v = winqueryreg (rootkey, subkey, value_name)
v = winqueryreg (rootkey, subkey)

Input argument


rootkey

a string: root key.

subkey

a string: subkey path.

value_name

a string: name of value.

Output argument


c

a cell of strings.

v

a string or int32.

Description


c = winqueryreg ('name', rootkey, subkey) returns a cell of strings with key names in rootkey\subkey.

v = winqueryreg (rootkey, subkey, value_name) returns the value associated to value_name in rootkey\subkey.

If the value is a 32-bit integer, winqueryreg returns the value as int32. If this value is a string, it is a string.

v = winqueryreg (rootkey, subkey) returns value in rootkey\subkey that has no value name property.

Supported root keys:

'HKEY_CLASSES_ROOT', 'HKCR',

'HKEY_CURRENT_USER', 'HKCU',

'HKEY_LOCAL_MACHINE', 'HKLM',

'HKEY_USERS', 'HKU',

'HKEY_CURRENT_CONFIG', 'HKCC'

Example


winqueryreg('name', 'HKEY_LOCAL_MACHINE', 'HARDWARE\DESCRIPTION\System')
winqueryreg('HKLM', 'HARDWARE\DESCRIPTION\System\CentralProcessor\1\', 'ProcessorNameString')

See also


winopen, searchenv.

History


Version Description
1.0.0 initial version

Author


Allan CORNET

<< winopen OS functions