Macromedia coldfusion 4.5-cfml language reference User Manual
Chapter 2: ColdFusion Functions
513
SetProfileString
Sets the value of a profile entry in an initialization file. This function returns an empty
string if the operation succeeds or an error message if the operation fails.
string if the operation succeeds or an error message if the operation fails.
See also
GetProfileString
.
Syntax
SetProfileString(
iniPath, section, entry, value)
iniPath
Fully qualified path (drive, directory, filename, and extension) of the initialization
file.
file.
section
The section of the initialization file in which the entry is to be set.
entry
The name of the entry that is to be set.
value
The value to which to set the entry.
Example
<!---This example uses SetProfileString to set the
timeout value in an initialization file. --->
<HTML>
<HEAD>
<TITLE>SetProfileString Example</TITLE>
</HEAD>
<HEAD>
<TITLE>SetProfileString Example</TITLE>
</HEAD>
<body bgcolor="#FFFFD5">
<H3>SetProfileString Example</H3>
This example uses SetProfileString to set the value of timeout in an
initialization file. Enter the full path of your initialization file,
specify the timeout value, and submit the form.
initialization file. Enter the full path of your initialization file,
specify the timeout value, and submit the form.
<!--- This section of code checks to see if the form was submitted.
If the form was submitted, this section sets the initialization
If the form was submitted, this section sets the initialization
path and timeout value to the path and timeout value specified
in the form --->
in the form --->
<CFIF Isdefined("Form.Submit")>
<CFSET IniPath = FORM.iniPath>
<CFSET Section = "boot loader">
<CFSET MyTimeout = FORM.MyTimeout>
<CFSET timeout = GetProfileString(IniPath, Section, "timeout")>
<CFSET Section = "boot loader">
<CFSET MyTimeout = FORM.MyTimeout>
<CFSET timeout = GetProfileString(IniPath, Section, "timeout")>
<CFIF timeout Is Not MyTimeout>