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">
 
See also

Chapter 15, "Using Persistent Data and Locking," in ColdFusion MX Developer's Guide

 
Usage

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

 
Example
<!--- This example uses the cfregistry set action to modify registry value 
data. --->
<!--- Normally you pass in a filename 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>
ACTION  
  Required
 

Always set.
BRANCH  
  Required
 

Name of a registry branch.
ENTRY  
  Required
 

Key or value to set.
TYPE  
  Optional
 
  • string: sets a string value (default).
  • dWord: sets a DWord value.
  • key: creates a key.
VALUE  
  Optional
 

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

  • string: creates an empty string: "".
  • dWord: creates a value of 0 (zero).