Opening an Edition

For a publisher, use the OpenNewEdition function to initiate the writing of

data to an edition.

err = OpenNewEdition ( publisherSectionH, fdCreator,

publisherSectionDocument, refNum);

The publisherSectionH parameter is the publisher section that you are

writing to the edition. The fdCreator parameter is the Finder creator type of the

new edition icon.

The publisherSectionDocument parameter is the document that contains the

publisher. This parameter is used to create an alias from the edition to the

publisher's document. If you pass NIL for publisherSectionDocument, an alias

is not made in the edition file. The refNum parameter returns the reference

number for the edition.

For a subscriber, use the OpenEdition function to initiate the reading of data

from an edition.

err = OpenEdition ( subscriberSectionH, refNum);

The subscriberSectionH parameter is a handle to the section record for a

given section. The refNum parameter returns the reference number for the

edition.

The user may rename or move the edition in the Finder. Before writing to or

reading data from an edition, the Edition Manager verifies the name of the

edition. This process is referred to as synching or synchronization. Synching

ensures that the Edition Manager's existing edition names correspond to the

Finder's existing edition names by updating the control block.

Referenced by (4):