MACROMEDIA DREAMWEAVER 8-EXTENDING DREAMWEAVER Manual page 474

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.
If you want to read the file before writing to it, open the file in "
want to write to the file, close the read handle and open the file again in "
" " mode.
append
Arguments
char *fileURL, char *mode
The
char *fileURL
opening, which is provided as a file:// URL. If it specifies a path in the Dreamweaver
Configuration folder, the
opening the file.
The
char *mode
You can specify
null
the file does not exist, the
" ", the
write MM_OpenConfigFile()
you specify "
read
nonexclusive share.
If you open the file in "
writing new data. If you open the file in "
to the end 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.
474 C-Level Extensibility
function.
_close
argument is a pointer to a string that names the file that you are
MM_OpenConfigFile()
argument points to a string that specifies how you want to open the file.
, " ", " ", or "
read write
MM_OpenconfigFile()
function opens the file with an exclusive share. If
", the
MM_OpenConfigFile()
" mode, any existing data in the file is truncated before
write
function resolves the path before
" mode. If you specify "
append
function creates it. If you specify
function opens the file with a
" mode, any data you write is appended
append
" mode. When you
read
" or
write
" and
write