FLASH® LITE™ 2.x - Adobe Help and Support

■ If the minimumDiskSpace parameter exceeds the maximum space available for a SWF file,
or the remaining space available for a SWF file, or if there was an error processing the
request, flush() returns false.
If the flush() method returns pending, the Flash Lite player can show a dialog box asking
the user to free up space to increase the amount of disk space available to shared objects. To
allow space for the shared object to expand when it is saved in the future, which avoids return
values of pending , you can pass a value for minimumDiskSpace. When the Flash Lite player
tries to write the file, it searches for the number of bytes passed to minimumDiskSpace,
instead of searching for enough space to save the shared object at its current size.
Example
The following example handles the possible return values for the flush() method:
so_big = SharedObject.getLocal("large");
so_big.data.name = "This is a long string of text.";
so_big.flush();
var flushResult = so_big.flush();
switch (flushResult) {
case 'pending' :
result.text += "pending";
break;
case true :
result.text += "Data was flushed.";
break;
case false :
result.text += "Test failed. Data was not flushed.";
break;
}
See also
clear (SharedObject.clear method), onStatus (SharedObject.onStatus handler)
getLocal (SharedObject.getLocal method)
public static getLocal(name:String) : SharedObject
Returns a reference to a locally persistent shared object that is available only to the current
client. If the shared object does not already exist, getLocal() creates one. This method is a
static method of the SharedObject class.
Note: In Flash Lite, a shared object cannot be shared between two SWF files.
To assign the object to a variable, use syntax like the following
558 ActionScript classes