Navigation:  Actions > Miscellaneous >

Read Registry Action

Previous pageReturn to chapter overviewNext page

This action creates a step to read values from the Windows registry.  The REG_READ system macro can also be used to read values from the registry.

 

When the step completes, the following temporary macro is created or updated:

READ_REGISTRY_VALUE = The registry value, value names, or subkey names that were read

 

Root key: The root registry key/hive to access.

 

Subkey: The subkey to access (for instance, Software\Microsoft\Windows\CurrentVersion), required.

 

Value name: The value to read (optional).  The default value is read if an empty string is entered.  To load the names of all values under the subkey, enter 5 asterisk characters (*****); to load the names of all subkeys under the subkey, enter 5 + characters (+++++).  The Loop action can be used to process all matching value/key names.

 

Fail if key or value doesn't exist: If checked and the specified registry key or value doesn't exist, the step fails.  If unchecked, the default value will be used.

 

Default value: The value to use if the registry key or value doesn't exist (optional).

 

Macro name: The name of the temporary macro in which to store the value that was read from the registry (optional, defaults to storing in the READ_REGISTRY_VALUE macro if not specified).

 

Description: The description of the temporary macro where the text is stored (optional).

 

Do not escape special characters: Does not escape (double) special characters in the registry when storing in a macro.

 

Access 64-bit registry view: On 64-bit Windows, this action in the 32-bit edition of Visual Build accesses the 32-bit registry view by default.  If this option is checked, the action will access redirected keys in the 64-bit registry view.  This option is only available in the 32-bit edition of Visual Build and has no effect on 32-bit Windows or shared registry keys in 64-bit Windows (for more information, see Registry Keys Affected by WOW64).

 

Access 32-bit registry view: On 64-bit Windows, this action in the 64-bit edition of Visual Build accesses the 64-bit registry view by default.  If this option is checked, the action will access redirected keys in the 32-bit registry view.  This option is only available in the 64-bit edition of Visual Build.

 

Remote Tab