Int Mm_Openconfigfile() - MACROMEDIA DREAMWEAVER MX 2004-EXTENDING DREAMWEAVER Manual

int MM_OpenConfigFile()

Availability
Dreamweaver MX.
Description
This function opens the file and returns an operating system file handle. You can use the
operating system file handle in calls to system file functions. You must close the file handle with a
call to the system
If the file is a configuration file, it finds the file in either the user Configuration folder or the
Dreamweaver Configuration folder. If you open the Configuration file for writing, the function
creates the file in the user Configuration folder, even if it exists in the Dreamweaver
Configuration folder.
Note: If you want to read the file before writing to it, open the file in "read" mode. When you want to
write to the file, close the read handle and open the file again in "write" or "append" mode.
Arguments
char *fileURL, char *mode
•
The
char *fileURL
which is provided as a file:// URL. If it specifies a path in the Dreamweaver Configuration
folder, the
MM_OpenConfigFile()
•
The
char *mode
can specify
null
not exist, the
MM_OpenConfigFile()
the
MM_OpenConfigFile()
If you open the file in "
new data. If you open the file in "
of the file.
Returns
An integer that is the operating system file handle for this file. Returns -1 if the file cannot be
found or does not exist.
Example
char *dwConfig = "file:///c|/
Configuration/Extensions.txt";
int = fileno;
if(MM_ConfigFileExists(dwConfig))
{
fileno = MM_OpenConfigFile(dwConfig, "read");
}
function.
_close
argument is a pointer to a string that names the file that you are opening,
function resolves the path before opening the file.
argument points to a string that specifies how you want to open the file. You
, " ", " ", or "
read write
MM_OpenconfigFile()
function opens the file with an exclusive share. If you specify "
function opens the file with a nonexclusive share.
" mode, any existing data in the file is truncated before writing
write
append
P
rogram Files/Macromedia/Dreamweaver/
" mode. If you specify "
append
function creates it. If you specify "
" mode, any data you write is appended to the end
File Access and Multiuser Configuration API
" and the file does
write
", the
write
read
367
",