Table Of Contents

Create Registry Key (G Dataflow)

Last Modified: March 15, 2017

Creates a key in the Windows registry or opens the key, if it already exists.

spd-note-caution
Caution  

Incorrectly modifying the registry can damage Windows or prevent you from starting Windows.

connector_pane_image
datatype_icon

machine

Name of the networked machine.

Default: Empty — The local machine.

datatype_icon

options

Special options for the key.

Name Description
REG_OPTION_NON_VOLATILE

This node creates the key as non-volatile and preserves the information stored in memory when the OS is restarted.

REG_OPTION_VOLATILE

This node creates the key as volatile and does not preserve the information stored in memory when the corresponding registry hive is unloaded.

REG_OPTION_BACKUP_RESTORE

This node creates the key with access to backing up and restoring the key.

Default: REG_OPTION_NON_VOLATILE

datatype_icon

root key

Windows registry root key.

Name Description
HKEY_CLASSES_ROOT

Contains information about registered applications.

HKEY_CURRENT_USER

Stores settings that are specific to the currently logged-in user.

HKEY_LOCAL_MACHINE

Stores settings that are specific to the local computer.

HKEY_USERS

Contains subkeys corresponding to the HKEY_CURRENT_USER keys for each user profile actively loaded on the machine.

HKEY_PERFORMANCE_DATA

Provides runtime information into performance data provided by either the Windows NT kernel, or running system drivers, programs and services.

HKEY_CURRENT_CONFIG

Contains information gathered at runtime.

HKEY_DYN_DATA

Contains information about hardware devices. This key is used only on Windows 95, Windows 98 and Windows ME.

Default: HKEY_LOCAL_MACHINE

datatype_icon

subkey

Name of a subkey of root key.

A beginning backslash \ might cause an error.

Default: Empty string

datatype_icon

security access mask

Access rights to assign the key.

Name Description
KEY_QUERY_VALUE

Access right to query the values of a registry key.

KEY_SET_VALUE

Access right to create, delete, or set a registry value.

KEY_CREATE_SUB_KEY

Access right to create a subkey of a registry key.

KEY_ENUMERATE_SUB_KEYS

Access right to enumerate the subkeys of a registry key.

KEY_NOTIFY

Access right to request change notifications for a registry key or for subkeys of a registry key.

KEY_CREATE_LINK

Access right reserved for system use.

KEY_READ

Access right that combines the STANDARD_RIGHTS_READ, KEY_QUERY_VALUE, KEY_ENUMERATE_SUB_KEYS, and KEY_NOTIFY values.

KEY_WRITE

Access right that combines the STANDARD_RIGHTS_WRITE, KEY_SET_VALUE, and KEY_CREATE_SUB_KEY values.

KEY_ALL_ACCESS

Access right that combines the STANDARD_RIGHTS_REQUIRED, KEY_QUERY_VALUE, KEY_SET_VALUE, KEY_CREATE_SUB_KEY, KEY_ENUMERATE_SUB_KEYS, KEY_NOTIFY, and KEY_CREATE_LINK values.

KEY_READ | KEY_WRITE

Access right that combines the KEY_READ and KEY_WRITE values.

Default: KEY_READ | KEY_WRITE

datatype_icon

error in

Error conditions that occur before this node runs.

The node responds to this input according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Default: No error

datatype_icon

class

Class or object type of the key.

datatype_icon

registry view

Value that specifies whether to create a 32-bit key or a 64-bit key on a 64-bit operating system.

Name Value Description
Default 0 This node selects the type of key based on the software that is installed. For example, if a 64-bit product is installed, this node creates a 64-bit key.
KEY_WOW64_64KEY 8 This node creates a 64-bit key.
KEY_WOW64_32KEY 9 This node creates a 32-bit key.

Default: Default

datatype_icon

reference

Reference to the open registry key.

datatype_icon

action taken

Action taken by the node.

Name Description
Unknown The action taken is unknown.
REG_CREATED_NEW_KEY This node created a new key.
REG_OPENED_EXISTING_KEY This node opened an existing key.
datatype_icon

error out

Error information.

The node produces this output according to standard error behavior.

Standard Error Behavior

Many nodes provide an error in input and an error out output so that the node can respond to and communicate errors that occur while code is running. The value of error in specifies whether an error occurred before the node runs. Most nodes respond to values of error in in a standard, predictable way.

error in does not contain an error error in contains an error
If no error occurred before the node runs, the node begins execution normally.

If no error occurs while the node runs, it returns no error. If an error does occur while the node runs, it returns that error information as error out.

If an error occurred before the node runs, the node does not execute. Instead, it returns the error in value as error out.

Where This Node Can Run:

Desktop OS: Windows

FPGA: This product does not support FPGA devices


Recently Viewed Topics