RegQueryValue

Returns data item string at subkey position.

Syntax:

RegQueryValue(handle, subkey-string [,view-flag])

Parameters:

(i) handle handle to a registration database key.

(s) subkey-string a path from the key provided to the desired key, including the "data item name" in square brackets
at the end of the key string.

(i) view-flag [optional] controls which registry view the function uses when accessing the Windows registry.
0 - view indicated by the last call to the RegOpenFlags.
32 - use the 32-bit registry view.
64 - use the 64-bit registry view.

Returns:

(s) contents (value) of data item at key position desired.

 

Use this function to retrieve data items from the Registration Database. The function will fail if the data item does not exist.

Note: Named data entries are specified by enclosing the data item name in square brackets at the end of the key string.

View-flag

This optional parameter controls which registry view the function uses when accessing the Windows registry. The optional parameter's values can be 32 to use the 32-bit view, 64 to use the 64-bit view, or 0 to use the view indicated by the last call to the RegOpenFlags. The parameter value of 0 can also causes a function to use the WinBatch default 64-bit view, if no call to RegOpenFlags has been made and setting the parameter to 0 is equivalent to omitting the parameter entirely.

Notes:

Windows Vista/2008 and newer: This function may require an Administrator level account, if it attempts to access protected registry keys: HKEY_LOCAL_MACHINE  or HKEY_CLASSES_ROOT.

Example:
root = @REGMACHINE
subkey = "SOFTWARE\Microsoft\Windows NT\CurrentVersion[ProductName]"
If RegExistValue(root, subkey)
   value = RegQueryValue(root, subkey)
   Message("Windows Product Name", value)
Else
   Message("Notice: Subkey Not Found", subkey)
EndIf
See Also:

RegApp, RegEntryType, RegQueryBin, RegQueryDword, RegQueryEx, RegQueryExpSz, RegQueryItem, RegQueryMulSz, RegQueryValue, RegQueryStr and the section on Registration Database Operations