InstallShield 2016 » 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 RegDBCopyKeys function copies the registry keys and 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
RegDBCopyKeys ( szSourceKey, szTargetKey, nRootKeySource, nRootKeyTarget );
Parameters
|
Parameter |
Description |
||||||||||||||||||
|
szSourceKey |
Specifies the name of the key whose subkeys and 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; this includes values under identically named subkeys. |
||||||||||||||||||
|
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 keys and values. |
|
< ISERR_SUCCESS |
Indicates that the function was unable to copy the keys and 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 2016 Help LibraryMay 2017 |
Copyright Information | Flexera Software |