OpenNewEdition

Initiate the writing of data from a publisher

#include <Editions.h> Edition Manager

OSErr OpenNewEdition ( publisherSectionH, fdCreator,

publisherSectionDocument, refNum);

SectionHandle publisherSectionH ; is the publisher section

OSType fdCreator ; Ûis the Finder creator type

const FSSpec * publisherSectionDocument ; is the document that contains the

publisher

EditionRefNum *refNum ; Ûreturns the reference number for

the edition.

returns ÛError Code; 0=no error

To initiate the writing of data from a publisher to its edition container, use

the OpenNewEdition function.

publisherSectionH is the publisher section that is writing to the edition

fdCreator is the Finder creator type of the new edition icon.

publisherSectionDocument 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.

refNum returns the reference number for the edition. This

parameter is necessary for subsequent calls to

CloseEdition to specify which publisher is writing

its data to an edition. If the edition cannot be opened

for writing because there is another publisher

writing to it, or because the file system does not allow

writing, an error is returned and refNum is set to NIL.

Returns: an operating system Error Code.

noErr (0) No error

flLckdErr (-45) Edition in use by another section

permErr (-54) Registered publisher on another machine

wrPermErr (-61) Not a publisher

editionMgrInitErr (-450) Manager not initialized

Notes: The OpenNewEdition function returns an flLckdErr result code if there

is a subscriber on another machine reading data from the same edition. The

OpenNewEdition function returns a permErr result code if there is a

registered publisher to that edition on another machine.

The Edition Manager allows two registered publishers that are located

on the same machine to write to the same edition. Note that multiple

publishers cannot write to the same edition simultaneously--only one

publisher can write to an edition at a given time.

In addition, you may also receive file creating, file opening, file reading,

resolve alias, and memory errors.

Referenced by (9):