winqueryreg

Get item from Microsoft Windows registry (Windows only)

Calling Sequence

value = winqueryreg('name', 'rootkey','subkey')
value = winqueryreg('rootkey', 'subkey','valname')
value = winqueryreg('rootkey','subkey')

Description

value = winqueryreg(‘name’, ‘rootkey’, ‘subkey’) returns the key names in rootkeysubkey in a matrix of strings. The first argument is the literal quoted string, ‘name’.

If the value retrieved from the registry is a string, winqueryreg returns a string. If the value is a 32-bit integer, winqueryreg returns the value as an integer (int32).

value = winqueryreg(‘rootkey’, ‘subkey’, ‘valname’) returns the value for key valname in rootkeysubkey.

value = winqueryreg(‘rootkey’, ‘subkey’) returns a value in rootkeysubkey that has no value name property.

`Note`The literal name argument and the rootkey argument are case- sensitive. The subkey and valname arguments are not.

supported root keys are: ‘HKEY_CLASSES_ROOT’, ‘HKEY_CURRENT_USER’, ‘HKEY_LOCAL_MACHINE’, ‘HKEY_USERS’, ‘HKEY_DYN_DATA’ and ‘HKEY_CURRENT_CONFIG’.

Examples

if `getos`_() == 'Windows' then
  winqueryreg 'HKEY_LOCAL_MACHINE' 'HARDWARE\DESCRIPTION\System\CentralProcessor\0\' 'ProcessorNameString'
  mousechar = winqueryreg('name', 'HKEY_CURRENT_USER','control panel\mouse');
  len=`size`_(mousechar);
  for k=1:len(1)
     setting = winqueryreg('HKEY_CURRENT_USER','control panel\mouse', mousechar(k));
     if (mousechar(k)=='') then mousechar(k)='default';,end
     str = `msprintf`_('%s = %s', mousechar(k), `string`_(setting));
     `disp`_(str);
  end
  winqueryreg('HKEY_CURRENT_CONFIG', 'Software\Fonts\','LogPixels')
end

History

Version Description 5.4.0 This function also manages ‘HKEY_CURRENT_CONFIG’ key.