Microsoft® Windows® Script Host
RegRead Method
WSH Reference
Version 1

See Also                      Applies To


Description
Returns the registry key or value named by strName.
Syntax
object.RegRead(strName)
Parameters
Part Description
object WshShell object.
strName Key or value name to read.
Remarks
If strName ends with the backslash character (\), this method returns the key instead of the value. StrName must begin with one of following root key names:

Short Long
HKCU HKEY_CURRENT_USER
HKLM HKEY_LOCAL_MACHINE
HKCR HKEY_CLASSES_ROOT
HKEY_USERS
HKEY_CURRENT_CONFIG

The RegRead method supports only REG_SZ, REG_EXPAND_SZ, REG_DWORD, REG_BINARY, and REG_MULTI_SZ data types. If the registry has other data types, RegRead returns DISP_E_TYPEMISMATCH.

Example
The following example reads a value and key from the registry:
Set WshShell = WScript.CreateObject("WScript.Shell")
WScript.Echo WshShell.RegRead("HKCU\ScriptEngine\Val")  ' Read from value "Val".
WScript.Echo WshShell.RegRead("HKCU\ScriptEngine\Key\") ' Read from key "Key".