CFREGISTRY ACTION = "GET"  
Description

Accesses a registry value and stores it in a ColdFusion variable.

 
Syntax
<cfregistry 
   action = "get"
   branch = "branch"
   entry = "key or value"
   variable = "variable"
   type = "data type">
 
See also

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

 
Usage

If the value does not exist, the cfregistry tag does not create an entry.

 
Example
<!--- This example uses cfregistry with the get action. --->
<cfregistry action = "get"
 branch = "HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM" 
 entry = "ClassPath" type = "String" variable = "RegValue">
<h1>cfregistry action = "get"</h1>
<cfoutput>
   <p>Java ClassPath value is #RegValue#
</cfoutput>
ACTION  
  Required
 

Always get.
BRANCH  
  Required
 

Name of a registry branch.
ENTRY  
  Required
 

Registry value to access.
VARIABLE  
  Required
 

Variable into which to put value.
TYPE  
  Optional
 
Default value: "string"
  • string: returns string value.
  • dWord: returns DWord value.
  • key: returns key's default value.