Start of change

Save a held optical file

Saving a held optical file physically writes the data and file attributes to the optical disk. You can choose to save to the original volume, directory, and file name that you specified at open time, or to a new optical file path.

In some situations, you can save the file at the original storage destination. For example, if the file has been opened with a normal open type, the file is now inaccessible through the HFS API, rendering the open file handle no longer valid. However, the condition that caused the file to become held might have been corrected, giving you the ability to save the data by specifying the held file as the destination.

If the application specifies a different file path as the destination, the file must not already exist. If appropriate, you can delete such a file before attempting to save to that volume, directory, and file name.

After a held optical file is saved, it should be released to allow the file to be used by future applications.

End of change