InstallShield 2019 » InstallScript Language Reference
Project • For InstallScript MSI and Basic MSI projects, it is recommended that you use the Registry view in InstallShield instead of creating registry keys and values through InstallScript code. Handling all of your registry changes in this way allows for a clean uninstallation through the Windows Installer service.
The RegDBCopyValues function copies the registry values under the key specified by szSourceKey to the key specified by szTargetKey.
Note • This function supports the 64-bit parts of the registry by using the REGDB_OPTION_WOW64_64KEY option. For more information, see REGDB_OPTIONS.
Syntax
RegDBCopyValues ( szSourceKey, szTargetKey, nRootKeySource, nRootKeyTarget );
Parameters
|
Parameter |
Description |
||||||||||||||||||
|
szSourceKey |
Specifies the name of the key whose values are to be copied. Separate different levels in the subkey with a double backslash (\\). |
||||||||||||||||||
|
szTargetKey |
Specifies the name of the key to be copied to. Separate different levels in the subkey with a double backslash (\\). If this key does not exist, RegDBCopyKeys creates it. If this key does exist, any existing values under the key that have the same names as values under szSourceKey are overwritten. |
||||||||||||||||||
|
nRootKeySource |
Specifies the root key of szSourceKey. Pass one of the following predefined constants in this parameter:
|
||||||||||||||||||
|
nRootKeyTarget |
Specifies the root key of szTargetKey. Pass one of the following predefined constants in this parameter:
|
Return Values
|
Return Value |
Description |
|
>= ISERR_SUCCESS |
Indicates that the function successfully copied the values. |
|
< ISERR_SUCCESS |
Indicates that the function was unable to copy the values. You can obtain the error message text associated with a large negative return value—for example, -2147024891 (0x80070005)—by calling FormatMessage. |
Additional Information
By default, any text that is surrounded by angle brackets—for example, "<my registry entry text>"—in this function’s string arguments is interpreted as a text substitution and is processed accordingly. To disable text substitution processing for the string arguments of registry functions, call Disable with the REGISTRYFUNCTIONS_USETEXTSUBS argument.
See Also
InstallShield 2019 Help LibraryApril 2019 |
Copyright Information | Flexera |