Legacy Document

Inside Macintosh: Interapplication Communication /

Chapter 2 - Edition Manager / Edition Manager Reference

Edition Manager Routines / Locating a Publisher and Edition From a Subscriber

GetEditionInfo

Use the GetEditionInfo function to obtain information about a section's edition, such as its location, last modification date, creator, and type.

FUNCTION GetEditionInfo
                     (sectionH: SectionHandle; 
                      VAR editionInfo: EditionInfoRecord): OSErr;

sectionH

A handle to the section record for a given section.

editionInfo

An edition information record. The GetEditionInfo function returns the public information contained in the section's control block.

DESCRIPTION

The Edition Manager ensures that the existing edition name corresponds to the Finder's existing edition name. If the controlBlock field of the section record is set to NIL or the edition cannot be located, the GetEditionInfo function returns an fnfErr result code.

The GetEditionInfo function returns information about the section's edition in a data structure of type EditionInfoRecord.

TYPE EditionInfoRecord = 
   RECORD
      crDate:     TimeStamp;           {date edition container }
                                       { was created}
      mdDate:     TimeStamp;           {date of last change}
      fdCreator:  OSType;              {file creator}
      fdType:     OSType;              {file type}
      container:  EditionContainerSpec;{the edition}
   END;

Field Description

crDate

The creation date of the edition.

mdDate

The modification date of the edition.

fdCreator

The creator of the edition file.

fdType

The file type of the edition file.

container

An edition container record, which specifies the volume reference number, directory ID, filename, script, and part number for the edition.

RESULT CODES

noErr	0	No error
fnfErr	-43	Not registered or file moved
editionMgrInitErr	-450	Manager not initialized

SEE ALSO

For an example of the use of GetEditionInfo, see Listing 2-8 beginning on page 2-46. For another use of this function, see "Canceling Sections Within Documents" beginning on page 2-48. For a description of the edition container record, see page 2-71.