Programming ColdFusion MX, 2nd Edition

Name

cfregistry

Synopsis

<cfregistry>

Performs an operation on the Windows registry, based on the value of the action attribute. In ColdFusion MX, configuration information is stored in XML configuration files, not the system registry.

Attributes

action=" action "

The action for the cfregistry tag to take. Required. Get retrieves a value from the registry and stores it in a variable. GetAll retrieves all the registry keys and values for a specified registry branch and stores them in a query object. Delete deletes a key or value from the registry. Set adds or updates a registry key or value.

branch=" branch "

For Get, GetAll, and Set, the name of the registry branch containing the value to be accessed or set. For Delete, specifies either the name of the registry key to be deleted (don’t specify an entry) or the name of the registry branch that contains the value to be deleted (specify a value for entry). Required.

entry=" key_or_value "

The value in the registry to be operated on. Required for all actions except GetAll and certain Delete operations.

maxrows=" integer "

The maximum number of rows to retrieve when action is GetAll and type is Key. Optional. The default is to retrieve all remaining rows. This attribute is new in ColdFusion MX.

name=" query_name "

The name of a query object to hold the keys and values returned by cfregistry. Required for GetAll; ignored otherwise.

sort=" sort_criteria "

The sort order for the result set obtained by the cfregistry action. Results ...