MACROMEDIA FLASH MX 2004 - ACTIONSCRIPT Reference Manual page 621

If this method returns
increase the amount of disk space available to objects from this domain. To allow space for the
shared object to "grow" when it is saved in the future, thus avoiding return values of
pass a value for
minimumDiskSpace
bytes passed to
minimumDiskSpace
object at its current size.
For example, if you expect a shared object to grow to a maximum size of 500 bytes, even though
it may start out much smaller, pass 500 for
space for the shared object, it will ask for 500 bytes. After the user allots the requested amount of
space, Flash won't have to ask for more space on future attempts to flush the object (as long as its
size doesn't exceed 500 bytes).
After the user responds to the dialog box, this method is called again and returns either
; also,
false SharedObject.onStatus
SharedObject.Flush.Success
For more information, see
Example
The following function gets a shared object,
settings. Finally,
flush()
disk space.
this.SyncSettingsCore=function(soname, override, settings)
{
var SO=SharedObject.getLocal(soname, "http://www.mydomain.com/app/sys");
// settings list index
var i;
// For each specified value in settings:
// If override is true, set the persistent setting to the provided value.
// If override is false, fetch the persistent setting, unless there
// isn't one, in which case, set it to the provided value.
for (i in settings) {
if (override || (SO.data[i] == null)) {
SO.data[i]= settings[i];
} else {
settings[i]= SO.data[i];
}
}
SO.flush(1000);
}
, the Flash Player displays a dialog box asking the user to
"pending"
. When Flash tries to write the file, it looks for the number of
, instead of looking for just enough space to save the shared
minimumDiskSpace
is invoked with a
or
SharedObject.Flush.Failed
"Local disk space considerations" on page
is called to save the settings and allot a minimum of 1000 bytes of
. If Flash asks the user to allot disk
property of
code
, and fills writable properties with user-provided
SO
"pending"
true
.
617.
SharedObject.flush()
,
or
621