RegQueryMulSz

Retrieves a REG_MULTI_SZ value from the registry.

Syntax:

RegQueryMulSz(handle, subkey-string, delimiter [,view-flag])

Parameters:

(i) handle an open registration database key (see below).

(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.

(s) delimiter a character to act as a delimiter between items.

(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) list of strings, delimited with the specified delimiter character.

 

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:


key=RegCreateKey(@REGCURRENT, "sample")
RegSetMulSz(key, "testmulz[foods]", "apple|pear|grapes|toast", "|")
RegCloseKey(key)
a1=RegOpenKey(@REGCURRENT, "sample")
c=RegQueryMulSz(a1, "testmulz[foods]",@TAB)
RegCloseKey(a1)
Message("Foods",c)
See Also:

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