cfregistry action = "set"

Description

Adds a registry key, adds a value, or updates a value.

Syntax

<cfregistry 
  action = "set"
  branch = "branch"
  entry = "key or value"
  type = "value type"
  value = "data">

Attributes

Attribute Req/Opt Default Description

action
Required

set

branch
Required

Name of a registry branch.

entry
Required

Key or value to set.

type
Optional

string: set a string value (default).

dWord: set a DWord value.

key: create a key.

value
Optional

Value data to set. If you omit this attribute, cfregistry creates default value, as follows:

string: creates an empty string: ""

dWord: creates a value of 0 (zero)

Attribute	Req/Opt	Description
action	Required	set
branch	Required	Name of a registry branch.
entry	Required	Key or value to set.
type	Optional	string: set a string value (default). dWord: set a DWord value. key: create a key.
value	Optional	Value data to set. If you omit this attribute, `cfregistry` creates default value, as follows: string: creates an empty string: `""` dWord: creates a value of `0` (zero)

Usage

If it does not exist, cfregistry creates the key or value.

Example

<!--- This example uses cfregistry Set Action to modify registry value data --->
<!--- Normally you pass in a file name instead of setting one here. --->
<cfset FileName = "dummy.cfm">
<cfregistry action = "set"
 branch = "HKEY_LOCAL_MACHINE\Software\cflangref"
 entry = "LastCFM01" type = "String" value = "#FileName#">
<h1>cfregistry action = "set"</h1>

Version 6

Comments are no longer accepted for ColdFusion MX. ColdFusion 8 is the current version.

Send me an e-mail when comments are added to this page | Comment Report

Current page: http://livedocs.adobe.com/coldfusion/6/CFML_Reference/Tags-pt223.htm

CFML Reference