cfregistry

Description

This tag is deprecated for the UNIX platform.

History

ColdFusion MX: Deprecated this tag on the UNIX platform. It might not work, and might cause an error, in later releases. Changed how persistent data is stored: ColdFusion now stores most persistent data outside the system registry, in XML files. cfregistry action = "getAll"

Syntax

The tag syntax depends on the action attribute value. See the following sections:cfregistry action = "get" cfregistry action = "set" cfregistry action = "getAll" cfregistry action = "delete"

Attributes

Attribute	Description	Required	Default
action	Always getall.	Required
branch	Name of a registry branch.	Required
name	Name of record set to contain returned keys and values.	Required
sort	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.	Optional	asc
type	string: returns string values. dWord: returns DWord values. key: returns keys. any: returns keys and values.	Optional	string

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

cfregistry action = "get"

cfmldocs