CloseEdition
EditionRefNum whichEdition ; is the reference number for the edition. Boolean successful ; Was application able to read or write data? After finishing reading from or writing to an edition, use the CloseEdition function to close the edition.
whichEdition is the reference number for the edition.
successful indicates whether your application was successful in reading or
writing data to the edition.
noErr (0) No error
rfNumErr (-51) Bad edition reference number
editionMgrInitErr (-450) Manager not initialized
Notes: When a subscriber successfully finishes reading data from the edition, the
CloseEdition function takes the modification date of the edition file that you have read and puts it in the mdDate field of the subscriber's
section record. This indicates that the data contained in the edition and the
subscriber section within the document are the same.
When a subscriber is unsuccessful in reading data from an edition
(because there is not enough memory, or you did not find a format that you
function then closes the edition, but does not set the mdDate field. This
implies that the subscriber is not updated with the latest edition.
When a publisher successfully finishes writing data to an edition, the
CloseEdition function makes the data that the publisher has written to the edition available to any subscribers and sets the corresponding edition
file's modification date (ioFlMdDat) to the mdDate field of the publisher's
all current subscribers set to automatic update mode . At this point, the file
type of the edition file is set based on the first known format that the
publisher wrote.
When a publisher is unsuccessful in writing data to an edition, the
CloseEdition function discards what the publisher has written to the edition. The data contained in the edition prior to writing remains
unchanged, and Section Read events are not sent to subscribers.