Specifications

Chapter 21260
• sz is the size of the string, in bytes. If sz is 0, the length of the null-terminated string is
computed automatically.
• rval is a pointer to a single jsval. The function’s return value is stored in *rval.
Returns
A Boolean value that indicates success (JS_TRUE) or failure (JS_FALSE).
JSBool JS_ReportError()
Description
Describes the reason for a script error. Call this function before returning JS_FALSE to give the
user information about why the script failed (for example, “wrong number of arguments”).
Arguments
JSContext *cx, char *error, size_t sz
• cx is the opaque JSContext pointer that passed to the JavaScript function.
• error is a string that contains the error message. The string is copied, so the caller should free
the string when it is no longer needed. If the string size is not specified (see the
sz argument,
below), the string must be null-terminated.
• sz is the size of the string, in bytes. If sz is 0, the length of the null-terminated string is
computed automatically.
Returns
A Boolean value that indicates success (JS_TRUE) or failure (JS_FALSE).
File Access and Multiuser Configuration API
Macromedia recommends that you always use the File Access and Multiuser Configuration API
to access the file system through C-level extensions. For files other than configuration files, the
functions access the specified file or folder.
Dreamweaver MX supports multiple-user configurations for the multiple-user operating systems
of Windows XP, Windows 2000, Windows NT, and Mac OS X.
Typically, you install Dreamweaver MX in a restricted folder such as C:\Program Folders in
Windows. As a result, only users with Administrator privileges can make changes in the
Dreamweaver MX configuration folder. To enable users on multiple-user operating systems to
create and maintain individual configurations, Dreamweaver MX creates a separate configuration
folder for each user. Any time Dreamweaver MX or a JavaScript extension writes to the
configuration folder, Dreamweaver MX automatically writes to the user configuration folder
instead. In this way, Dreamweaver MX lets each user customize the Dreamweaver MX
configuration settings without disturbing the customized configurations of other users.