CFREGISTRY ACTION = "GETALL"  
Description

Returns all registry keys and values defined in a branch. You can access the values as you would any record set.

 
Syntax
<cfregistry 
   action = "getAll"
   branch = "branch"
   type = "data type"
   name = "query name" 
   sort = "criteria">
 
See also

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

 
Usage

This tag returns #entry#, #type#, and #value# in a record set that you can access through tags such as cfoutput. To fully qualify these variables, use the record set name, as specified in the name attribute.

If #type# is a key, #value# is an empty string.

If you specify type= "any", getAll also returns binary registry values. For binary values, the #type# variable contains UNSUPPORTED and #value# is blank.

 
Example
<!--- This example uses cfregistry with the getAll action. --->
<cfregistry action = "getAll"
   branch = "HKEY_LOCAL_MACHINE\Software\Microsoft\Java VM" 
   type = "Any" name = "RegQuery">
<p><h1>cfregistry action = "getAll"</h1>
<cftable query = "RegQuery" colHeaders HTMLTable border = "Yes">
<cfcol header = "<b>Entry</b>" width = "35" text = "#RegQuery.Entry#">
<cfcol header = "<b>Type</b>" width = "10" text = "#RegQuery.type#">
<cfcol header = "<b>Value</b>" width = "35" text = "#RegQuery.Value#">
</cftable>
ACTION  
  Required
 

Always getall.
BRANCH  
  Required
 

Name of a registry branch.
TYPE  
  Optional
 
Default value: "String"
  • string: returns string values.
  • dWord: returns DWord values.
  • key: returns keys.
  • any: returns keys and values.
NAME  
  Required
 

Name of record set to contain returned keys and values.
SORT  
  Optional
 
Default value: "ASC"

Sorts query column data (case-insensitive). Sorts on Entry, Type, and Value columns as text. Specify a combination of columns from query output, in a comma-delimited list. For example: 

sort = "value desc, entry asc"
  • asc: ascending (a to z) sort order.
  • desc: descending (z to a) sort order.