User Guide

32 The HTTP API
■ The prompt argument, which is optional, is a Boolean value that specifies whether to
prompt the user to save the file. If
saveURL is outside the Configuration/Temp folder, a
prompt value of false is ignored for security reasons.
■ The saveURL argument, which is optional, is the location on the user’s hard disk where
the file should be saved, which is expressed as a file:// URL. If prompt is a
true value or
saveURL is outside the Configuration/Temp folder, the user can override saveURL in the
Save dialog box.
■ The titleBarLabel argument, which is optional, is the label that should appear in the
title bar of the Save dialog box.
Returns
An object that represents the reply from the server. The data property of this object is a string
that contains the location where the file is saved, which is expressed as a file:// URL.
Normally, the
statusCode property of the object contains the status code that is received
from the server. However, if a disk error occurs while Dreamweaver is saving the file on the
local drive, the
statusCode property contains an integer that represents one of the following
error codes if the operation is not successful:
■ 1: Unspecified error
■ 2: File not found
■ 3: Invalid path
■ 4: Number of open files limit reached
■ 5: Access denied
■ 6: Invalid file handle
■ 7: Cannot remove current working folder
■ 8: No more folder entries
■ 9: Error setting file pointer
■ 10: Hardware error
■ 11: Sharing violation
■ 12: Lock violation
■ 13: Disk full
■ 14: End of file reached
000_DW_API_Print.book Page 32 Wednesday, July 20, 2005 11:58 AM